SignerSignEx (función)
La función SignerSignEx firma el archivo especificado y devuelve un puntero a los datos firmados.
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 SignerSignEx(
_In_ DWORD dwFlags,
_In_ SIGNER_SUBJECT_INFO *pSubjectInfo,
_In_ SIGNER_CERT *pSignerCert,
_In_ SIGNER_SIGNATURE_INFO *pSignatureInfo,
_In_opt_ SIGNER_PROVIDER_INFO *pProviderInfo,
_In_opt_ LPCWSTR pwszHttpTimeStamp,
_In_opt_ PCRYPT_ATTRIBUTES psRequest,
_In_opt_ LPVOID pSipData,
_Out_ SIGNER_CONTEXT **ppSignerContext
);
Parámetros
-
dwFlags [in]
-
Modifica el comportamiento de esta función.
Si el archivo que se va a firmar es un archivo ejecutable portátil (PE), puede ser cero o una combinación de uno o varios de los valores siguientes. Estos identificadores se definen en Mssip.h.
Valor Significado - SPC_EXC_PE_PAGE_HASHES_FLAG
- 0x10
Excluya los hashes de página al crear datos indirectos SIP para el archivo PE. Esta marca tiene prioridad sobre la marca de SPC_INC_PE_PAGE_HASHES_FLAG .
Si no se especifica ni el SPC_EXC_PE_PAGE_HASHES_FLAG ni la marca SPC_INC_PE_PAGE_HASHES_FLAG , el valor establecido con la función WintrustSetDefaultIncludePEPageHashes se usa para esta configuración. El valor predeterminado para esta configuración es excluir hashes de página al crear datos indirectos SIP para archivos PE.
Windows Server 2003 y Windows XP: Este valor no se admite.- SPC_INC_PE_IMPORT_ADDR_TABLE_FLAG
- 0x20
Este valor no se admite. - SPC_INC_PE_DEBUG_INFO_FLAG
- 0x40
Este valor no se admite. - SPC_INC_PE_RESOURCES_FLAG
- 0x80
Este valor no se admite. - SPC_INC_PE_PAGE_HASHES_FLAG
- 0x100
Incluya hashes de página al crear datos indirectos SIP para el archivo PE.
Windows Server 2003 y Windows XP: Este valor no se admite. -
pSubjectInfo [in]
-
Puntero a una estructura de SIGNER_SUBJECT_INFO que especifica el sujeto al signo.
-
pSignerCert [in]
-
Puntero a una estructura de SIGNER_CERT que especifica el certificado que se va a usar para crear la firma digital.
-
pSignatureInfo [in]
-
Puntero a una estructura SIGNER_SIGNATURE_INFO que contiene información sobre la firma digital.
-
pProviderInfo [in, optional]
-
Puntero a una estructura de SIGNER_PROVIDER_INFO que especifica el proveedor de servicios criptográficos (CSP) y la información de clave privada usada para crear la firma digital.
Si el valor de este parámetro es NULL, el valor del parámetro pSignerCert debe especificar un certificado asociado a un CSP.
-
pwszHttpTimeStamp [in, optional]
-
Dirección URL de un servidor de marca de tiempo.
-
psRequest [in, optional]
-
Puntero a una matriz de estructuras de CRYPT_ATTRIBUTE que se agregan a una solicitud de firma. Este parámetro se omite si el parámetro pwszHttpTimeStamp no contiene un valor válido que no sea NULL.
-
pSipData [in, optional]
-
Valor de 32 bits que se pasa como datos adicionales a funciones SIP. El formato y el contenido de esto se definen mediante el proveedor SIP.
-
ppSignerContext [out]
-
Dirección de un puntero a la estructura SIGNER_CONTEXT que contiene el BLOB firmado. Cuando haya terminado de usar la estructura SIGNER_CONTEXT , libere la estructura de SIGNER_CONTEXT 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 |
|
Consulte también