SetSignatureInfo Method (GdPicturePDF) - DocuVieware Reference Guide

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Function SetSignatureInfo( _
   ByVal Name As String, _
   ByVal Reason As String, _
   ByVal Location As String, _
   ByVal ContactInfo As String _
) As GdPictureStatus

public GdPictureStatus SetSignatureInfo( 
   string Name,
   string Reason,
   string Location,
   string ContactInfo
)

public function SetSignatureInfo( 
    Name: String;
    Reason: String;
    Location: String;
    ContactInfo: String
): GdPictureStatus;

public function SetSignatureInfo( 
   Name : String,
   Reason : String,
   Location : String,
   ContactInfo : String
) : GdPictureStatus;

public: GdPictureStatus SetSignatureInfo( 
   string* Name,
   string* Reason,
   string* Location,
   string* ContactInfo
)

public:
GdPictureStatus SetSignatureInfo( 
   String^ Name,
   String^ Reason,
   String^ Location,
   String^ ContactInfo
)

Parameters

Name: The name of the person or authority signing the document.
Reason: The reason for the signing the document.
Location: The (physical) location of the signing.
ContactInfo: Information provided by the signer to enable a recipient to contact the signer to verify the signature, for example a phone number.

Return Value

A member of the GdPictureStatus enumeration. If the method has been successfully followed, then the return value is GdPictureStatus.OK.

We strongly recommend always checking this status first.

This method is only allowed for use with non-encrypted documents.

This step is optional. In case the additional information is not provided the signing process will extract necessary information from the certificate.

This method requires the Digital Signatures component to run.

How to set up additional information for the subsequent signing. You can find the complete sample within the ApplySignature() method's example.

VB.NET
C#

Dim caption As String = "SetSignatureInfo"
Dim gdpicturePDF As New GdPicturePDF()
            
'Please load the PDF document you want to sign.
            
'Please set the corresponding certificate - this is a mandatory step.
            
Dim status As GdPictureStatus = gdpicturePDF.SetSignatureInfo("Orpalis", "Important PDF", "Toulouse (France)", "contact@orpalis.com")
If status <> GdPictureStatus.OK Then
    MessageBox.Show("The method SetSignatureInfo() has failed with the status " + status.ToString(), caption)
    Goto [Error]
End If
            
'Please see the complete sample in the ApplySignature() method for next steps to follow.
            
[error]:
gdpicturePDF.Dispose()

string caption = "SetSignatureInfo";
GdPicturePDF gdpicturePDF = new GdPicturePDF();
            
//Please load the PDF document you want to sign.
            
//Please set the corresponding certificate - this is a mandatory step.
            
GdPictureStatus status = gdpicturePDF.SetSignatureInfo("Orpalis", "Important PDF", "Toulouse (France)", "contact@orpalis.com");
if (status != GdPictureStatus.OK)
{
    MessageBox.Show("The method SetSignatureInfo() has failed with the status " + status.ToString(), caption);
    goto error;
}
            
//Please see the complete sample in the ApplySignature() method for next steps to follow.
            
error:
gdpicturePDF.Dispose();

Reference

GdPicturePDF Class
GdPicturePDF Members
ApplySignature(String,PdfSignatureMode,Boolean) Method
SetSignaturePos Method
GetSignatureCount Method
GetSignatureProperties Method