SignerTimeStampEx function (Windows)

Switch View :
ScriptFree
SignerTimeStampEx function

Applies to: desktop apps only

The SignerTimeStampEx function time stamps the specified subject and optionally returns a pointer to a SIGNER_CONTEXT structure that contains a pointer to a BLOB. This function supports Authenticode time stamping. To perform X.509 Public Key Infrastructure (RFC 3161) time stamping, use the SignerTimeStampEx2 function.

Note  This function has no associated header file or import library. To call this function, you must create a user-defined header file and use the LoadLibrary and GetProcAddress functions to dynamically link to Mssign32.dll.

Syntax

HRESULT WINAPI SignerTimeStampEx(
  __reserved  DWORD dwFlags,
  __in        SIGNER_SUBJECT_INFO *pSubjectInfo,
  __in        LPCWSTR pwszHttpTimeStamp,
  __in        PCRYPT_ATTRIBUTES psRequest,
  __in        LPVOID pSipData,
  __out       SIGNER_CONTEXT **ppSignerContext 
);

Parameters

dwFlags [in]

Reserved. This parameter must be set to zero.

pSubjectInfo [in]

The address of a SIGNER_SUBJECT_INFO structure that represents the subject to be time stamped.

pwszHttpTimeStamp [in]

The address of a null-terminated Unicode string that contains the URL of a time stamp server.

psRequest [in]

Optional. The address of a CRYPT_ATTRIBUTES structure that contains additional attributes that are added to the time stamp request.

This parameter is optional and can be NULL if it is not included.

pSipData [in]

Optional. A 32-bit value that is passed as additional data to subject interface package (SIP) functions. The format and content of this parameter is defined by the SIP provider.

This parameter is optional and can be NULL if it is not included.

ppSignerContext [out]

Optional. The address of a pointer to the SIGNER_CONTEXT structure that contains the signed BLOB. When you have finished using the SIGNER_CONTEXT structure, free it by calling the SignerFreeSignerContext function.

Return value

If the function succeeds, the function returns S_OK.

If the function fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

DLL

Mssign32.dll

See also

SignerTimeStamp

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012