Función CryptSIPPutSignedDataMsg (mssip.h)

  • Artículo

La función CryptSIPPutSignedDataMsg almacena una firma Authenticode en el archivo de destino.

Sintaxis

BOOL CryptSIPPutSignedDataMsg(
  [in]  SIP_SUBJECTINFO *pSubjectInfo,
  [in]  DWORD           dwEncodingType,
  [out] DWORD           *pdwIndex,
  [in]  DWORD           cbSignedDataMsg,
  [in]  BYTE            *pbSignedDataMsg
);

Parámetros

[in] pSubjectInfo

Puntero a una estructura de SIP_SUBJECTINFO que contiene información sobre el asunto del mensaje.

[in] dwEncodingType

Tipo de codificación del mensaje. Puede ser una combinación de uno o varios de los valores siguientes.

Valor Significado
PKCS_7_ASN_ENCODING
65536 (0x10000)
 Especifica la codificación de mensajes PKCS #7 .
X509_ASN_ENCODING
1 (0x1)
 Especifica la codificación de certificados X.509 .

[out] pdwIndex

Puntero al índice del mensaje.

[in] cbSignedDataMsg

Longitud, en bytes, del búfer al que apunta el parámetro pbSignedDataMsg .

[in] pbSignedDataMsg

Puntero al búfer que contiene el mensaje.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve TRUE.

Si se produce un error en la función, devuelve FALSE. Para obtener información de error extendida, llame a GetLastError. Siguen algunos códigos de error posibles.

Código devuelto Descripción
ERROR_BAD_FORMAT
 El formato de archivo o datos especificados del paquete de interfaz de asunto (SIP) no es válido.
ERROR_INVALID_PARAMETER
 Este código se puede devolver por los siguientes motivos:
  • pSubjectInfo es NULL.
  • PdwIndex es NULL.
  • PbSignedDataMsg es NULL.
  • El valor del parámetro cbSignedDataMsg es menor que uno.
    • [SIP_SUBJECTINFO] Estructura (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo). [SIP_SUBJECTINFO] Estructura (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo).
TRUST_E_SUBJECT_FORM_UNKNOWN
 El tipo de sujeto especificado no es válido.

Comentarios

Cada tipo de sujeto usa un subconjunto diferente de sus datos para el cálculo hash y requiere un procedimiento diferente para el almacenamiento y la recuperación. Por lo tanto, cada tipo de sujeto tiene una especificación SIP única.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mssip.h
Library Crypt32.lib
Archivo DLL Crypt32.dll

Consulte también

CryptSIPGetSignedDataMsg

CryptSIPRemoveSignedDataMsg