CMSG_CNG_CONTENT_DECRYPT_INFO struttura (wincrypt.h)

La struttura CMSG_CNG_CONTENT_DECRYPT_INFO contiene tutte le informazioni pertinenti passate tra CryptMsgControle le funzioni installabili (OID) per l'importazione e la decrittografia di un'API di crittografia: chiave di crittografia (CNG) del contenuto (CEK). La funzione CryptMsgControl usa questa struttura per chiamare le funzioni seguenti:

• PFN_CMSG_CNG_IMPORT_KEY_TRANS
• PFN_CMSG_CNG_IMPORT_KEY_AGREE
• PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY

Sintassi

typedef struct _CMSG_CNG_CONTENT_DECRYPT_INFO {
  DWORD                      cbSize;
  CRYPT_ALGORITHM_IDENTIFIER ContentEncryptionAlgorithm;
  PFN_CMSG_ALLOC             pfnAlloc;
  PFN_CMSG_FREE              pfnFree;
  NCRYPT_KEY_HANDLE          hNCryptKey;
  BYTE                       *pbContentEncryptKey;
  DWORD                      cbContentEncryptKey;
  BCRYPT_KEY_HANDLE          hCNGContentEncryptKey;
  BYTE                       *pbCNGContentEncryptKeyObject;
} CMSG_CNG_CONTENT_DECRYPT_INFO, *PCMSG_CNG_CONTENT_DECRYPT_INFO;

Members

cbSize

Contiene le dimensioni, in byte, di questa struttura.

ContentEncryptionAlgorithm

Struttura CRYPT_ALGORITHM_IDENTIFIER che specifica l'algoritmo usato per crittografare il contenuto del messaggio e tutti i parametri associati.

pfnAlloc

Puntatore a una funzione installabile usata per allocare memoria per qualsiasi membro aggiornato.

pfnFree

Puntatore a una funzione installabile usata per liberare memoria allocata da pfnAlloc.

hNCryptKey

Handle per la chiave privata CNG da usare per la decrittografia della chiave CEK contenuta nel parametro pKeyTransDecryptPara o il parametro pKeyAgreeDecryptPara della funzione PFN_CMSG_CNG_IMPORT_KEY_TRANS. Le funzioni di callback devono usare questa chiave anziché quella contenuta nella struttura DecryptPara perché tale struttura potrebbe contenere un handle HCRYPTPROV convertito.

pbContentEncryptKey

Usando il membro hNCryptKey, la funzione PFN_CMSG_CNG_IMPORT_KEY_TRANS deve aggiornare questo membro decrittografando il codice CEK nel parametro pKeyTransDecryptParao la funzionePFN_CMSG_CNG_IMPORT_KEY_AGREE deve aggiornare questo membro decrittografando il parametro EncryptedKey nel parametro pKeyAgreeDecryptPara. La memoria per questo membro deve essere allocata usando il membro pfnAlloc . La funzione PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY userà questi byte come segreto per generare il membro hCNGContentEncryptKey . Anche per un errore, è necessario liberare e zero qualsiasi memoria allocata usando il membro pfnFree .

cbContentEncryptKey

La funzione PFN_CMSG_CNG_IMPORT_KEY_TRANS o PFN_CMSG_CNG_IMPORT_KEY_AGREE deve aggiornare questo membro con le dimensioni, in byte, del membro pbContentEncryptKey precedente.

hCNGContentEncryptKey

La funzione PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY deve aggiornare questo membro con il BCRYPT_KEY_HANDLE generato da usare per la decrittografia del contenuto. Anche per un errore, è necessario rilasciare questo handle usando la funzione BCryptDestroyKey .

pbCNGContentEncryptKeyObject

La funzione PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY deve aggiornare questo membro con la memoria allocata dal membro pfnAlloc da associare al membro hCNGContentEncryptKey . Anche per un errore, è necessario liberare e zero qualsiasi memoria allocata usando il membro pfnFree .

Requisiti