Pdftools SDK
Loading...
Searching...
No Matches
Macros | Typedefs | Functions
PdfTools_PdfToolsCryptoProvidersSwisscomSigSrv.h File Reference
#include "PdfTools_Types.h"
#include "PdfTools_PdfToolsSys.h"

Go to the source code of this file.

Macros

#define PDFTOOLS_CALL
 
#define TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequired    TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredA
 
#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_AddConsentRequiredHandler    PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_AddConsentRequiredHandlerA
 
#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_RemoveConsentRequiredHandler    PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_RemoveConsentRequiredHandlerA
 
#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_New   PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_NewA
 
#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMSISDN   PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMSISDNA
 
#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMSISDN   PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMSISDNA
 
#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMessage   PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMessageA
 
#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMessage   PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMessageA
 
#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetLanguage    PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetLanguageA
 
#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetLanguage    PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetLanguageA
 
#define PdfToolsCryptoProvidersSwisscomSigSrv_Session_New   PdfToolsCryptoProvidersSwisscomSigSrv_Session_NewA
 
#define PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForStaticIdentity    PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForStaticIdentityA
 
#define PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForOnDemandIdentity    PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForOnDemandIdentityA
 
#define PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateTimestamp    PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateTimestampA
 

Typedefs

typedef void(PDFTOOLS_CALLTPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredA) (void *pContext, const char *szUrl)
 
typedef void(PDFTOOLS_CALLTPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredW) (void *pContext, const WCHAR *szUrl)
 

Functions

PDFTOOLS_EXPORT TPdfToolsCrypto_HashAlgorithm PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_GetHashAlgorithm (TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *pSignatureConfiguration)
 The message digest algorithm.
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_SetHashAlgorithm (TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *pSignatureConfiguration, TPdfToolsCrypto_HashAlgorithm iHashAlgorithm)
 The message digest algorithm.
 
PDFTOOLS_EXPORT TPdfToolsCrypto_SignatureFormat PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_GetSignatureFormat (TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *pSignatureConfiguration)
 The format (encoding) of the cryptographic signature Default: ePdfToolsCrypto_SignatureFormat_AdbePkcs7Detached.
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_SetSignatureFormat (TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *pSignatureConfiguration, TPdfToolsCrypto_SignatureFormat iSignatureFormat)
 The format (encoding) of the cryptographic signature Default: ePdfToolsCrypto_SignatureFormat_AdbePkcs7Detached.
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_GetAddTimestamp (TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *pSignatureConfiguration)
 Whether to add a trusted time-stamp to the signature Default: FALSE.
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_SetAddTimestamp (TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *pSignatureConfiguration, BOOL bAddTimestamp)
 Whether to add a trusted time-stamp to the signature Default: FALSE.
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_GetEmbedValidationInformation (TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *pSignatureConfiguration)
 Whether to embed validation information into the signature (LTV)
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_SetEmbedValidationInformation (TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *pSignatureConfiguration, BOOL bEmbedValidationInformation)
 Whether to embed validation information into the signature (LTV)
 
PDFTOOLS_EXPORT TPdfToolsCrypto_HashAlgorithm PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration_GetHashAlgorithm (TPdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration *pTimestampConfiguration)
 The message digest algorithm.
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration_SetHashAlgorithm (TPdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration *pTimestampConfiguration, TPdfToolsCrypto_HashAlgorithm iHashAlgorithm)
 The message digest algorithm.
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_AddConsentRequiredHandlerA (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, void *pContext, TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredA pFunction)
 Adds event handler.
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_AddConsentRequiredHandlerW (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, void *pContext, TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredW pFunction)
 Adds event handler.
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_RemoveConsentRequiredHandlerA (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, void *pContext, TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredA pFunction)
 Removes event handler.
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_RemoveConsentRequiredHandlerW (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, void *pContext, TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredW pFunction)
 Removes event handler.
 
PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_NewA (const char *szMsisdn, const char *szMessage, const char *szLanguage)
 
PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_NewW (const WCHAR *szMsisdn, const WCHAR *szMessage, const WCHAR *szLanguage)
 
PDFTOOLS_EXPORT size_t PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMSISDNA (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, char *pBuffer, size_t nBufferSize)
 The mobile phone number Example: "+41798765432"
 
PDFTOOLS_EXPORT size_t PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMSISDNW (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, WCHAR *pBuffer, size_t nBufferSize)
 The mobile phone number Example: "+41798765432"
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMSISDNA (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, const char *szMSISDN)
 The mobile phone number Example: "+41798765432"
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMSISDNW (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, const WCHAR *szMSISDN)
 The mobile phone number Example: "+41798765432"
 
PDFTOOLS_EXPORT size_t PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMessageA (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, char *pBuffer, size_t nBufferSize)
 The message to be displayed on the mobile phone Example: "Do you authorize your signature on Contract.pdf?"
 
PDFTOOLS_EXPORT size_t PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMessageW (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, WCHAR *pBuffer, size_t nBufferSize)
 The message to be displayed on the mobile phone Example: "Do you authorize your signature on Contract.pdf?"
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMessageA (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, const char *szMessage)
 The message to be displayed on the mobile phone Example: "Do you authorize your signature on Contract.pdf?"
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMessageW (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, const WCHAR *szMessage)
 The message to be displayed on the mobile phone Example: "Do you authorize your signature on Contract.pdf?"
 
PDFTOOLS_EXPORT size_t PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetLanguageA (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, char *pBuffer, size_t nBufferSize)
 The language of the message Example: "DE"
 
PDFTOOLS_EXPORT size_t PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetLanguageW (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, WCHAR *pBuffer, size_t nBufferSize)
 The language of the message Example: "DE"
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetLanguageA (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, const char *szLanguage)
 The language of the message Example: "DE"
 
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetLanguageW (TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp, const WCHAR *szLanguage)
 The language of the message Example: "DE"
 
PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_Session *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_NewA (const char *szUrl, TPdfTools_HttpClientHandler *pHttpClientHandler)
 
PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_Session *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_NewW (const WCHAR *szUrl, TPdfTools_HttpClientHandler *pHttpClientHandler)
 
PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForStaticIdentityA (TPdfToolsCryptoProvidersSwisscomSigSrv_Session *pSession, const char *szIdentity, const char *szName)
 Create a signature configuration for a static certificate.
 
PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForStaticIdentityW (TPdfToolsCryptoProvidersSwisscomSigSrv_Session *pSession, const WCHAR *szIdentity, const WCHAR *szName)
 Create a signature configuration for a static certificate.
 
PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForOnDemandIdentityA (TPdfToolsCryptoProvidersSwisscomSigSrv_Session *pSession, const char *szIdentity, const char *szDistinguishedName, TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp)
 Create a signature configuration for an on-demand certificate.
 
PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForOnDemandIdentityW (TPdfToolsCryptoProvidersSwisscomSigSrv_Session *pSession, const WCHAR *szIdentity, const WCHAR *szDistinguishedName, TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *pStepUp)
 Create a signature configuration for an on-demand certificate.
 
PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateTimestampA (TPdfToolsCryptoProvidersSwisscomSigSrv_Session *pSession, const char *szIdentity)
 Create a time-stamp configuration.
 
PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateTimestampW (TPdfToolsCryptoProvidersSwisscomSigSrv_Session *pSession, const WCHAR *szIdentity)
 Create a time-stamp configuration.
 

Macro Definition Documentation

◆ PDFTOOLS_CALL

#define PDFTOOLS_CALL

◆ PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForOnDemandIdentity

#define PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForOnDemandIdentity    PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForOnDemandIdentityA

◆ PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForStaticIdentity

#define PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForStaticIdentity    PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForStaticIdentityA

◆ PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateTimestamp

#define PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateTimestamp    PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateTimestampA

◆ PdfToolsCryptoProvidersSwisscomSigSrv_Session_New

#define PdfToolsCryptoProvidersSwisscomSigSrv_Session_New   PdfToolsCryptoProvidersSwisscomSigSrv_Session_NewA

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_AddConsentRequiredHandler

#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_AddConsentRequiredHandler    PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_AddConsentRequiredHandlerA

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetLanguage

#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetLanguage    PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetLanguageA

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMessage

#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMessage   PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMessageA

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMSISDN

#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMSISDN   PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMSISDNA

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_New

#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_New   PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_NewA

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_RemoveConsentRequiredHandler

#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_RemoveConsentRequiredHandler    PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_RemoveConsentRequiredHandlerA

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetLanguage

#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetLanguage    PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetLanguageA

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMessage

#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMessage   PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMessageA

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMSISDN

#define PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMSISDN   PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMSISDNA

◆ TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequired

#define TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequired    TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredA

Typedef Documentation

◆ TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredA

typedef void(PDFTOOLS_CALL * TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredA) (void *pContext, const char *szUrl)

Event containing the URL for step-up authentication using password and SMS challenge (OTP). Password and SMS challenge are used as a fallback mechanism for the Mobile ID authentication. For example, if the Mobile ID of the user is not activated. The user must be redirected to this URL for consent of will.

Parameters
[in,out]pContextContext of the event callback.
[in]szUrlThe consent URL where the user must be redirected to acknowledge the declaration of will.

◆ TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredW

typedef void(PDFTOOLS_CALL * TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredW) (void *pContext, const WCHAR *szUrl)

Event containing the URL for step-up authentication using password and SMS challenge (OTP). Password and SMS challenge are used as a fallback mechanism for the Mobile ID authentication. For example, if the Mobile ID of the user is not activated. The user must be redirected to this URL for consent of will.

Parameters
[in,out]pContextContext of the event callback.
[in]szUrlThe consent URL where the user must be redirected to acknowledge the declaration of will.

Function Documentation

◆ PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForOnDemandIdentityA()

PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForOnDemandIdentityA ( TPdfToolsCryptoProvidersSwisscomSigSrv_Session * pSession,
const char * szIdentity,
const char * szDistinguishedName,
TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp )

Create a signature configuration for an on-demand certificate.

Parameters
[in,out]pSessionActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_Session.
[in]szIdentityThe Claimed Identity string as provided by Swisscom: ‹customer name›:‹key identity› Example: "ais-90days-trial:OnDemand-Advanced4"
[in]szDistinguishedNameThe requested distinguished name of the on-demand certificate. Example: "cn=Hans Muster,o=ACME,c=CH"
[in,out]pStepUpOptions for step-up authorization using Mobile ID.
Returns
NULL if there is an error.
Note
An error occurred when NULL was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForOnDemandIdentityW()

PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForOnDemandIdentityW ( TPdfToolsCryptoProvidersSwisscomSigSrv_Session * pSession,
const WCHAR * szIdentity,
const WCHAR * szDistinguishedName,
TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp )

Create a signature configuration for an on-demand certificate.

Parameters
[in,out]pSessionActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_Session.
[in]szIdentityThe Claimed Identity string as provided by Swisscom: ‹customer name›:‹key identity› Example: "ais-90days-trial:OnDemand-Advanced4"
[in]szDistinguishedNameThe requested distinguished name of the on-demand certificate. Example: "cn=Hans Muster,o=ACME,c=CH"
[in,out]pStepUpOptions for step-up authorization using Mobile ID.
Returns
NULL if there is an error.
Note
An error occurred when NULL was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForStaticIdentityA()

PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForStaticIdentityA ( TPdfToolsCryptoProvidersSwisscomSigSrv_Session * pSession,
const char * szIdentity,
const char * szName )

Create a signature configuration for a static certificate.

Parameters
[in,out]pSessionActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_Session.
[in]szIdentityThe Claimed Identity string as provided by Swisscom: ‹customer name›:‹key identity› Example: "ais-90days-trial:static-saphir4-ch"
[in]szNameName of the signer. This parameter is not used for certificate selection, but for the signature appearance and signature description in the PDF only. Example: "Signing Service TEST account"
Returns
NULL if there is an error.
Note
An error occurred when NULL was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForStaticIdentityW()

PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateSignatureForStaticIdentityW ( TPdfToolsCryptoProvidersSwisscomSigSrv_Session * pSession,
const WCHAR * szIdentity,
const WCHAR * szName )

Create a signature configuration for a static certificate.

Parameters
[in,out]pSessionActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_Session.
[in]szIdentityThe Claimed Identity string as provided by Swisscom: ‹customer name›:‹key identity› Example: "ais-90days-trial:static-saphir4-ch"
[in]szNameName of the signer. This parameter is not used for certificate selection, but for the signature appearance and signature description in the PDF only. Example: "Signing Service TEST account"
Returns
NULL if there is an error.
Note
An error occurred when NULL was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateTimestampA()

PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateTimestampA ( TPdfToolsCryptoProvidersSwisscomSigSrv_Session * pSession,
const char * szIdentity )

Create a time-stamp configuration.

Parameters
[in,out]pSessionActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_Session.
[in]szIdentityThe Claimed Identity string as provided by Swisscom: ‹customer name› Example: "ais-90days-trial"
Returns
NULL if there is an error.
Note
An error occurred when NULL was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateTimestampW()

PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_CreateTimestampW ( TPdfToolsCryptoProvidersSwisscomSigSrv_Session * pSession,
const WCHAR * szIdentity )

Create a time-stamp configuration.

Parameters
[in,out]pSessionActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_Session.
[in]szIdentityThe Claimed Identity string as provided by Swisscom: ‹customer name› Example: "ais-90days-trial"
Returns
NULL if there is an error.
Note
An error occurred when NULL was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_Session_NewA()

PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_Session *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_NewA ( const char * szUrl,
TPdfTools_HttpClientHandler * pHttpClientHandler )
Parameters
[in]szUrlThe service endpoint base URL. Example: https://ais.swisscom.com
[in,out]pHttpClientHandlerThe SSL configuration with the client certificate and trust store. Use PdfTools_HttpClientHandler_SetClientCertificate to set your SSL client certificate "clientcert.p12" of your Swisscom Signing Service account.
Returns
Handle to the newly created native object.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage. Possible error codes:

◆ PdfToolsCryptoProvidersSwisscomSigSrv_Session_NewW()

PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_Session *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_Session_NewW ( const WCHAR * szUrl,
TPdfTools_HttpClientHandler * pHttpClientHandler )
Parameters
[in]szUrlThe service endpoint base URL. Example: https://ais.swisscom.com
[in,out]pHttpClientHandlerThe SSL configuration with the client certificate and trust store. Use PdfTools_HttpClientHandler_SetClientCertificate to set your SSL client certificate "clientcert.p12" of your Swisscom Signing Service account.
Returns
Handle to the newly created native object.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage. Possible error codes:

◆ PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_GetAddTimestamp()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_GetAddTimestamp ( TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration * pSignatureConfiguration)

Whether to add a trusted time-stamp to the signature Default: FALSE.

Parameters
[in,out]pSignatureConfigurationActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when FALSE was returned and the error code returned by PdfTools_GetLastError is different from ePdfTools_Error_Success. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_GetEmbedValidationInformation()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_GetEmbedValidationInformation ( TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration * pSignatureConfiguration)

Whether to embed validation information into the signature (LTV)

Default: TRUE

Parameters
[in,out]pSignatureConfigurationActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when FALSE was returned and the error code returned by PdfTools_GetLastError is different from ePdfTools_Error_Success. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_GetHashAlgorithm()

PDFTOOLS_EXPORT TPdfToolsCrypto_HashAlgorithm PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_GetHashAlgorithm ( TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration * pSignatureConfiguration)

The message digest algorithm.

The algorithm used to hash the document and from which the cryptographic signature is created.

Default: ePdfToolsCrypto_HashAlgorithm_Sha256

Parameters
[in,out]pSignatureConfigurationActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage. Possible error codes:

◆ PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_GetSignatureFormat()

PDFTOOLS_EXPORT TPdfToolsCrypto_SignatureFormat PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_GetSignatureFormat ( TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration * pSignatureConfiguration)

The format (encoding) of the cryptographic signature Default: ePdfToolsCrypto_SignatureFormat_AdbePkcs7Detached.

Parameters
[in,out]pSignatureConfigurationActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage. Possible error codes:

◆ PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_SetAddTimestamp()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_SetAddTimestamp ( TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration * pSignatureConfiguration,
BOOL bAddTimestamp )

Whether to add a trusted time-stamp to the signature Default: FALSE.

Parameters
[in,out]pSignatureConfigurationActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration.
[in]bAddTimestampSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_SetEmbedValidationInformation()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_SetEmbedValidationInformation ( TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration * pSignatureConfiguration,
BOOL bEmbedValidationInformation )

Whether to embed validation information into the signature (LTV)

Default: TRUE

Parameters
[in,out]pSignatureConfigurationActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration.
[in]bEmbedValidationInformationSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_SetHashAlgorithm()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_SetHashAlgorithm ( TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration * pSignatureConfiguration,
TPdfToolsCrypto_HashAlgorithm iHashAlgorithm )

The message digest algorithm.

The algorithm used to hash the document and from which the cryptographic signature is created.

Default: ePdfToolsCrypto_HashAlgorithm_Sha256

Parameters
[in,out]pSignatureConfigurationActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration.
[in]iHashAlgorithmSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage. Possible error codes:

◆ PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_SetSignatureFormat()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration_SetSignatureFormat ( TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration * pSignatureConfiguration,
TPdfToolsCrypto_SignatureFormat iSignatureFormat )

The format (encoding) of the cryptographic signature Default: ePdfToolsCrypto_SignatureFormat_AdbePkcs7Detached.

Parameters
[in,out]pSignatureConfigurationActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_SignatureConfiguration.
[in]iSignatureFormatSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage. Possible error codes:

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_AddConsentRequiredHandlerA()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_AddConsentRequiredHandlerA ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
void * pContext,
TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredA pFunction )

Adds event handler.

Parameters
[in,out]pStepUpPointer to the object to which the event handler is added.
[in,out]pContextThe context of the event handler.
[in]pFunctionThe event callback that is added.
Returns
TRUE if adding event handler was successful; FALSE if error occured.
Note
In case of an error, Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_AddConsentRequiredHandlerW()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_AddConsentRequiredHandlerW ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
void * pContext,
TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredW pFunction )

Adds event handler.

Parameters
[in,out]pStepUpPointer to the object to which the event handler is added.
[in,out]pContextThe context of the event handler.
[in]pFunctionThe event callback that is added.
Returns
TRUE if adding event handler was successful; FALSE if error occured.
Note
In case of an error, Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetLanguageA()

PDFTOOLS_EXPORT size_t PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetLanguageA ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
char * pBuffer,
size_t nBufferSize )

The language of the message Example: "DE"

Parameters
[in,out]pStepUpActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if there is an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetLanguageW()

PDFTOOLS_EXPORT size_t PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetLanguageW ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
WCHAR * pBuffer,
size_t nBufferSize )

The language of the message Example: "DE"

Parameters
[in,out]pStepUpActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if there is an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMessageA()

PDFTOOLS_EXPORT size_t PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMessageA ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
char * pBuffer,
size_t nBufferSize )

The message to be displayed on the mobile phone Example: "Do you authorize your signature on Contract.pdf?"

Parameters
[in,out]pStepUpActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if there is an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMessageW()

PDFTOOLS_EXPORT size_t PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMessageW ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
WCHAR * pBuffer,
size_t nBufferSize )

The message to be displayed on the mobile phone Example: "Do you authorize your signature on Contract.pdf?"

Parameters
[in,out]pStepUpActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if there is an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMSISDNA()

PDFTOOLS_EXPORT size_t PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMSISDNA ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
char * pBuffer,
size_t nBufferSize )

The mobile phone number Example: "+41798765432"

Parameters
[in,out]pStepUpActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if there is an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMSISDNW()

PDFTOOLS_EXPORT size_t PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_GetMSISDNW ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
WCHAR * pBuffer,
size_t nBufferSize )

The mobile phone number Example: "+41798765432"

Parameters
[in,out]pStepUpActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if there is an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_NewA()

PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_NewA ( const char * szMsisdn,
const char * szMessage,
const char * szLanguage )
Parameters
[in]szMsisdnThe mobile phone number
[in]szMessageThe message to be displayed on the mobile phone
[in]szLanguageThe language of the message
Returns
Handle to the newly created native object.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_NewW()

PDFTOOLS_EXPORT TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp *PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_NewW ( const WCHAR * szMsisdn,
const WCHAR * szMessage,
const WCHAR * szLanguage )
Parameters
[in]szMsisdnThe mobile phone number
[in]szMessageThe message to be displayed on the mobile phone
[in]szLanguageThe language of the message
Returns
Handle to the newly created native object.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_RemoveConsentRequiredHandlerA()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_RemoveConsentRequiredHandlerA ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
void * pContext,
TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredA pFunction )

Removes event handler.

Parameters
[in,out]pStepUpPointer to the object from which the event handler is removed.
[in,out]pContextThe context of the event handler.
[in]pFunctionThe event callback that is removed.
Returns
TRUE if removal was successful; FALSE if error occured.
Note
In case of an error, Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_RemoveConsentRequiredHandlerW()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_RemoveConsentRequiredHandlerW ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
void * pContext,
TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp_ConsentRequiredW pFunction )

Removes event handler.

Parameters
[in,out]pStepUpPointer to the object from which the event handler is removed.
[in,out]pContextThe context of the event handler.
[in]pFunctionThe event callback that is removed.
Returns
TRUE if removal was successful; FALSE if error occured.
Note
In case of an error, Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetLanguageA()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetLanguageA ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
const char * szLanguage )

The language of the message Example: "DE"

Parameters
[in,out]pStepUpActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp.
[in]szLanguageSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetLanguageW()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetLanguageW ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
const WCHAR * szLanguage )

The language of the message Example: "DE"

Parameters
[in,out]pStepUpActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp.
[in]szLanguageSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMessageA()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMessageA ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
const char * szMessage )

The message to be displayed on the mobile phone Example: "Do you authorize your signature on Contract.pdf?"

Parameters
[in,out]pStepUpActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp.
[in]szMessageSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMessageW()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMessageW ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
const WCHAR * szMessage )

The message to be displayed on the mobile phone Example: "Do you authorize your signature on Contract.pdf?"

Parameters
[in,out]pStepUpActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp.
[in]szMessageSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMSISDNA()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMSISDNA ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
const char * szMSISDN )

The mobile phone number Example: "+41798765432"

Parameters
[in,out]pStepUpActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp.
[in]szMSISDNSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMSISDNW()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_StepUp_SetMSISDNW ( TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp * pStepUp,
const WCHAR * szMSISDN )

The mobile phone number Example: "+41798765432"

Parameters
[in,out]pStepUpActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_StepUp.
[in]szMSISDNSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage.

◆ PdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration_GetHashAlgorithm()

PDFTOOLS_EXPORT TPdfToolsCrypto_HashAlgorithm PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration_GetHashAlgorithm ( TPdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration * pTimestampConfiguration)

The message digest algorithm.

The algorithm used to hash the document and from which the cryptographic signature is created.

Default: ePdfToolsCrypto_HashAlgorithm_Sha256

Parameters
[in,out]pTimestampConfigurationActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage. Possible error codes:

◆ PdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration_SetHashAlgorithm()

PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration_SetHashAlgorithm ( TPdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration * pTimestampConfiguration,
TPdfToolsCrypto_HashAlgorithm iHashAlgorithm )

The message digest algorithm.

The algorithm used to hash the document and from which the cryptographic signature is created.

Default: ePdfToolsCrypto_HashAlgorithm_Sha256

Parameters
[in,out]pTimestampConfigurationActs as a handle to the native object of type TPdfToolsCryptoProvidersSwisscomSigSrv_TimestampConfiguration.
[in]iHashAlgorithmSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling PdfTools_GetLastError. Get the error message with PdfTools_GetLastErrorMessage. Possible error codes: