SignerTimeStampEx (función)

Artículo
06/13/2023

La función SignerTimeStampEx marca el asunto especificado y, opcionalmente, devuelve un puntero a una estructura de SIGNER_CONTEXT que contiene un puntero a un BLOB. Esta función admite la marca de tiempo Authenticode. Para realizar la marca de tiempo X.509 Public Key Infrastructure (RFC 3161), use la función SignerTimeStampEx2 .

Nota

Esta función no tiene ningún archivo de encabezado asociado ni biblioteca de importación. Para llamar a esta función, debe crear un archivo de encabezado definido por el usuario y usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Mssign32.dll.

Sintaxis

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 
);

Parámetros

dwFlags [in]

Reservado. Este parámetro debe establecerse en cero.

pSubjectInfo [in]

Dirección de una estructura de SIGNER_SUBJECT_INFO que representa el sujeto al que se va a marcar la hora.

pwszHttpTimeStamp [in]

Dirección de una cadena Unicode terminada en null que contiene la dirección URL de un servidor de marca de tiempo.

psRequest [in]

Opcional. Dirección de una estructura de CRYPT_ATTRIBUTES que contiene atributos adicionales que se agregan a la solicitud de marca de tiempo.

Este parámetro es opcional y puede ser NULL si no está incluido.

pSipData [in]

Opcional. Valor de 32 bits que se pasa como datos adicionales a las funciones del paquete de interfaz de asunto (SIP). El proveedor SIP define el formato y el contenido de este parámetro.

Este parámetro es opcional y puede ser NULL si no está incluido.

ppSignerContext [out]

Opcional. Dirección de un puntero a la estructura SIGNER_CONTEXT que contiene el BLOB firmado. Cuando haya terminado de usar la estructura de SIGNER_CONTEXT , ábrela llamando a la función SignerFreeSignerContext .

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Archivo DLL	Mssign32.dll

Consulte también


SignerTimeStamp