Condividi tramite


Funzione CryptGetMessageSignerCount (wincrypt.h)

La funzione CryptGetMessageSignerCount restituisce il numero di firmatari di un messaggio firmato.

Nota

Questa funzione può restituire un conteggio dei firmatari duplicati e pertanto potrebbe non essere sufficiente per evitare attacchi. È consigliabile usare il campo sid (SignerIdentifier) di SignerInfo per identificare i firmatari duplicati in un messaggio.

Sintassi

LONG CryptGetMessageSignerCount(
  [in] DWORD      dwMsgEncodingType,
  [in] const BYTE *pbSignedBlob,
  [in] DWORD      cbSignedBlob
);

Parametri

[in] dwMsgEncodingType

Specifica il tipo di codifica utilizzato. È sempre accettabile specificare sia il certificato che i tipi di codifica dei messaggi combinandoli con un'operazione OR bit per bit, come illustrato nell'esempio seguente:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

I tipi di codifica attualmente definiti sono:

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pbSignedBlob

Puntatore a un buffer contenente il messaggio firmato.

[in] cbSignedBlob

Dimensione, in byte, del messaggio firmato.

Valore restituito

Restituisce il numero di firmatari di un messaggio firmato, zero quando non sono presenti firmatari e meno uno (-1) per un errore.

Per informazioni sugli errori estesi, chiamare GetLastError. Il codice di errore seguente viene restituito più comunemente.

Codice restituito Descrizione
E_INVALIDARG
Tipo di codifica del messaggio non valido. Attualmente è supportato solo PKCS_7_ASN_ENCODING.
 

Se la funzione ha esito negativo, GetLastError può restituire un errore di codifica/decodifica ASN.1 ( Abstract Syntax Notation One ). Per informazioni su questi errori, vedere Codifica ASN.1/Decodifica dei valori restituiti.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wincrypt.h
Libreria Crypt32.lib
DLL Crypt32.dll

Vedi anche

CryptVerifyMessageSignature

Funzioni di messaggio semplificate