PFN_CMSG_IMPORT_KEY_AGREE funzione di callback (wincrypt.h)

Articolo
07/16/2024

La funzione di callback PFN_CMSG_IMPORT_KEY_AGREE importa una chiave di crittografia del contenuto per un destinatario del trasporto chiave di un messaggio in busta. PFN_CMSG_IMPORT_KEY_AGREE può essere installato usando un CryptoAPI identificatore di oggetto (OID). Questa funzione viene chiamata dalla funzione CryptMsgControl quando il parametro dwCtrlType è impostato su CMSG_CTRL_DECRYPT.

Sintassi

PFN_CMSG_IMPORT_KEY_AGREE PfnCmsgImportKeyAgree;

BOOL PfnCmsgImportKeyAgree(
  [in]  PCRYPT_ALGORITHM_IDENTIFIER pContentEncryptionAlgorithm,
  [in]  PCMSG_CTRL_KEY_AGREE_DECRYPT_PARA pKeyAgreeDecryptPara,
  [in]  DWORD dwFlags,
        void *pvReserved,
  [out] HCRYPTKEY *phContentEncryptKey
)
{...}

Parametri

[in] pContentEncryptionAlgorithm

Puntatore a una struttura CRYPT_ALGORITHM_IDENTIFIER che specifica l'algoritmo utilizzato per crittografare il contenuto del messaggio ed eventuali parametri associati.

[in] pKeyAgreeDecryptPara

Puntatore a una struttura di CMSG_CTRL_KEY_AGREE_DECRYPT_PARA che contiene informazioni sul destinatario del contratto chiave.

[in] dwFlags

Questo valore non viene utilizzato. Impostarlo su zero.

pvReserved

Questo parametro è riservato e deve essere NULL.

[out] phContentEncryptKey

Indirizzo di un handle per la chiave di crittografia del contenuto restituita da questa funzione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero (TRUE).

Se la funzione ha esito negativo, il valore restituito è zero (FALSE). Per informazioni sugli errori estesi, chiamare GetLastError.

Se questa funzione di callback non supporta l'algoritmo di crittografia della chiave, deve restituire false e chiamare SetLastError con E_NOTIMPL.

Osservazioni

È possibile usare funzioni di supporto OID per distribuire questa funzione di callback. Wincrypt.h definisce le costanti seguenti a questo scopo.

Costante	Definizione
CMSG_OID_IMPORT_KEY_AGREE_FUNC o CMSG_OID_CAPI1_IMPORT_KEY_AGREE_FUNC	"CryptMsgDllImportKeyAgree"

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wincrypt.h

Condividi tramite