IPXC_Document::DeferedDigitalSignField Method

From PDF XChange PDF SDK
Jump to: navigation, search
 
(One intermediate revision by the same user not shown)
Line 5: Line 5:
 
{{ToReview}}
 
{{ToReview}}
  
Adds a digital signature to the specified field. Note that the signature will be applied only after the document was saved.
+
Adds a digital signature to the specified signature field if it wasn't signed before. Note that the signature will be applied only after the document was saved.
  
 
== Syntax ==
 
== Syntax ==
Line 20: Line 20:
 
:[in]  Pointer to [https://msdn.microsoft.com/en-us/library/windows/desktop/aa377189(v=vs.85).aspx _CERT_CONTEXT] containing both the encoded and decoded representations of a certificate.
 
:[in]  Pointer to [https://msdn.microsoft.com/en-us/library/windows/desktop/aa377189(v=vs.85).aspx _CERT_CONTEXT] containing both the encoded and decoded representations of a certificate.
 
;pField
 
;pField
:[in]  Pointer to [[PXV:IPXC_FormField|IPXC_FormField]] containing the field on which the signature will be applied to.
+
:[in]  Pointer to [[PXV:IPXC_FormField|IPXC_FormField]] containing the unsigned signature field to which the signature will be applied to.
 
;nFlags
 
;nFlags
 
:[in]  Value of ULONG containing the [[PXV:PXC_SignDocumentFlags|sign document flags]] that determine how the signature field should appear on the page.
 
:[in]  Value of ULONG containing the [[PXV:PXC_SignDocumentFlags|sign document flags]] that determine how the signature field should appear on the page.

Latest revision as of 00:18, 26 April 2016


Adds a digital signature to the specified signature field if it wasn't signed before. Note that the signature will be applied only after the document was saved.

Syntax

HRESULT DeferedDigitalSignField([in]  _CERT_CONTEXT*   pCert,
                                [in]  IPXC_FormField*  pField,
                                [in]  ULONG            nFlags,
                                [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.
pField
[in] Pointer to IPXC_FormField containing the unsigned signature field to which the signature will be applied to.
nFlags
[in] Value of ULONG containing the sign document flags that determine how the signature field should appear on the page.
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