Función CryptGetMessageSignerCount (wincrypt.h)
La función CryptGetMessageSignerCount devuelve el número de firmantes de un mensaje firmado.
Nota
Esta función puede devolver un recuento de firmantes duplicados y, por lo tanto, puede que no sea suficiente para evitar ataques. Se recomienda usar el campo sid (SignerIdentifier) de SignerInfo para identificar los firmantes duplicados en un mensaje.
Sintaxis
LONG CryptGetMessageSignerCount(
[in] DWORD dwMsgEncodingType,
[in] const BYTE *pbSignedBlob,
[in] DWORD cbSignedBlob
);
Parámetros
[in] dwMsgEncodingType
Especifica el tipo de codificación usado. Siempre es aceptable especificar los tipos de codificación de certificados y mensajes al combinarlos con una operación OR bit a bit, como se muestra en el ejemplo siguiente:
X509_ASN_ENCODING | PKCS_7_ASN_ENCODING
Los tipos de codificación definidos actualmente son:
- X509_ASN_ENCODING
- PKCS_7_ASN_ENCODING
[in] pbSignedBlob
Puntero a un búfer que contiene el mensaje firmado.
[in] cbSignedBlob
Tamaño, en bytes, del mensaje firmado.
Valor devuelto
Devuelve el número de firmantes de un mensaje firmado, cero cuando no hay ningún firmante y menos uno (–1) para un error.
Para obtener información de error extendida, llame a GetLastError. Normalmente se devuelve el código de error siguiente.
| Código devuelto | Descripción |
|---|---|
|
Tipo de codificación de mensaje no válido. Actualmente solo se admite PKCS_7_ASN_ENCODING. |
Si se produce un error en la función, GetLastError puede devolver un error de codificación y descodificación de sintaxis abstracta Uno (ASN.1). Para obtener información sobre estos errores, vea Valores devueltos de codificación/descodificación de ASN.1.
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 | wincrypt.h |
| Library | Crypt32.lib |
| Archivo DLL | Crypt32.dll |