IPXC_Document::DeferedDigitalSign Method

Latest revision as of 23:50, 25 April 2016

Adds a digital signature to the document, signs and places as required on the specified page. Note that the signature will be applied only after the document was saved.

Syntax

HRESULT DeferedDigitalSign([in]  _CERT_CONTEXT*  pCert,
                           [in]  ULONG           nFlags,
                           [in]  ULONG           nPageIdx,
                           [in]  PXC_Rect*       pRect,
                           [in]  LPWSTR          sReason,
                           [in]  LPWSTR          sLocation,
                           [in]  LPWSTR          sContactInfo,
                           [in]  LPWSTR          sImageFile);

Parameters

pCert

[in] Pointer to _CERT_CONTEXT containing both the encoded and decoded representations of a certificate.

nFlags

[in] Value of ULONG containing the sign document flags that determine how the signature field should appear on the page.

nPageIdx

[in] Value of ULONG containing the page index on which the signature field should be placed.

pRect

[in] Pointer to PXC_Rect specifying the bounding rectangle of the signature field.

sReason

[in] Value of LPWSTR specifying the reason for signing, such as (I agree...).

sLocation

[in] Value of LPWSTR specifying the CPU host name or physical location of the signing.

sContactInfo

[in] Value of LPWSTR specifying the information provided by the signatory to enable a recipient to contact the signatory to verify the signature; for example, a phone number.

sImageFile

[in] Value of LPWSTR specifying the full path and file name of the image (if any) to be displayed within the signature field.

Return Value

Returns S_OK if operation was successful or error code in other cases.

See Also

IPXC_Document