PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY funzione di callback (wincrypt.h)

  • Articolo

La funzione di callback PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY importa una chiave di crittografia del contenuto già decrittografata.The PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY callback function imports an already decrypted content encryption key (CEK). La funzione PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY può essere installata usando un'API di crittografia: identificatore di oggetto CNG (Next Generation) (OID).

Sintassi

PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY PfnCmsgCngImportContentEncryptKey;

BOOL PfnCmsgCngImportContentEncryptKey(
  [in, out] PCMSG_CNG_CONTENT_DECRYPT_INFO pCNGContentDecryptInfo,
  [in]      DWORD dwFlags,
            void *pvReserved
)
{...}

Parametri

[in, out] pCNGContentDecryptInfo

Puntatore a una struttura CMSG_CNG_CONTENT_DECRYPT_INFO da aggiornare con la chiave CEK importata. Questa struttura contiene tutte le informazioni pertinenti passate alla funzione CryptMsgControl .

[in] dwFlags

Questo parametro è riservato. Impostarlo su zero.

pvReserved

Questo parametro è riservato. Impostarlo su NULL.

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 ERROR_NOT_SUPPORTED.

Commenti

La funzione CryptMsgControl chiama questa funzione per le operazioni seguenti specificate dal parametro dwCtrlType :

CMSG_CTRL_DECRYPT
CMSG_CTRL_KEY_TRANS_DECRYPT
CMSG_CTRL_KEY_AGREE_DECRYPT

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

Costante Definizione
CMSG_OID_CNG_IMPORT_CONTENT_ENCRYPT_KEY_FUNC "CryptMsgDllCNGImportContentEncryptKey"
 

Esempio

Per un esempio che distribuisce una funzione di callback installabile tramite OID, vedere Estensione della funzionalità CryptoAPI.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wincrypt.h

Vedi anche

Decodifica dei dati in busta