Funzione CryptMsgCountersign (wincrypt.h)

La funzione CryptMsgCountersign controfirma una firma esistente in un messaggio. Le controfirmhe vengono usate per firmare l'hash crittografato di una firma esistente del messaggio. Le controfirma possono essere usate per vari scopi, tra cui il timestamp di un messaggio.

Sintassi

BOOL CryptMsgCountersign(
  [in, out] HCRYPTMSG                hCryptMsg,
  [in]      DWORD                    dwIndex,
  [in]      DWORD                    cCountersigners,
  [in]      PCMSG_SIGNER_ENCODE_INFO rgCountersigners
);

Parametri

[in, out] hCryptMsg

Handle dei messaggi crittografici da usare.

[in] dwIndex

Indice in base zero del firmatario nel messaggio firmato o firmato e in busta da controfirmare.

[in] cCountersigners

Numero di controfirmatori nella matrice rgCountersigners .

[in] rgCountersigners

Matrice di strutture di CMSG_SIGNER_ENCODE_INFO dei controfirmatori.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero (TRUE).

Se la funzione non riesce, restituisce zero (FALSE). Per informazioni sugli errori estesi, chiamare GetLastError.

È possibile propagare un errore da CryptMsgCountersignEncoded.

I codici di errore seguenti vengono restituiti più spesso.

Codice restituito	Descrizione
E_INVALIDARG	Uno o più argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente.
ERROR_MORE_DATA	L'area specificata non è sufficientemente grande da contenere i dati restituiti.

 

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 [app desktop | App UWP]
Server minimo supportato	Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincrypt.h
Libreria	Crypt32.lib
DLL	Crypt32.dll

Vedi anche

CryptMsgCountersignEncoded

CryptMsgVerifyCountersignaturaEncoded

Funzioni messaggio di basso livello

Funzioni di messaggio semplificate