SignerTimeStampEx2 (función)
La función SignerTimeStampEx2 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 se puede usar para realizar marcas de tiempo compatibles con X.509 Public Key Infrastructure, RFC 3161–compliant.
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 SignerTimeStampEx2(
_Reserved_ DWORD dwFlags,
_In_ SIGNER_SUBJECT_INFO *pSubjectInfo,
_In_ LPCWSTR pwszHttpTimeStamp,
_In_ ALG_ID dwAlgId,
_In_ PCRYPT_ATTRIBUTES psRequest,
_In_ LPVOID pSipData,
_Out_ SIGNER_CONTEXT **ppSignerContext
);
Parámetros
-
dwFlags [in]
-
Valor que especifica el tipo de marca de tiempo que se va a generar. Este parámetro puede ser uno de los valores siguientes. Los valores son mutuamente excluyentes.
Value Significado - SIGNER_TIMESTAMP_AUTHENTICODE
Especifica una marca de tiempo Authenticode. - SIGNER_TIMESTAMP_RFC3161
Especifica una marca de tiempo compatible con RFC 3161. -
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.
-
dwAlgId [in]
-
Especifica un algoritmo hash que se va a usar para realizar marcas de tiempo compatibles con RFC 3161. Este parámetro se omite para las marcas de tiempo authenticode.
-
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 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Archivo DLL |
|
Consulte también