PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY Rückruffunktion (wincrypt.h)
Die PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY Rückruffunktion importiert einen bereits entschlüsselten Inhaltsverschlüsselungsschlüssel (CEK). Die PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY-Funktion kann mithilfe einer Kryptografie-API installiert werden: CNG-Objektbezeichner ( OID) der nächsten Generation.
Syntax
PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY PfnCmsgCngImportContentEncryptKey;
BOOL PfnCmsgCngImportContentEncryptKey(
[in, out] PCMSG_CNG_CONTENT_DECRYPT_INFO pCNGContentDecryptInfo,
[in] DWORD dwFlags,
void *pvReserved
)
{...}
Parameter
[in, out] pCNGContentDecryptInfo
Ein Zeiger auf eine CMSG_CNG_CONTENT_DECRYPT_INFO Struktur, die mit dem importierten CEK aktualisiert werden soll. Diese Struktur enthält alle relevanten Informationen, die an die CryptMsgControl-Funktion übergeben werden.
[in] dwFlags
Dieser Parameter ist reserviert. Legen Sie ihn auf 0 (null) fest.
pvReserved
Dieser Parameter ist reserviert. Legen Sie sie auf NULL fest.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich null (TRUE).
Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (FALSE). Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.
Wenn diese Rückruffunktion den Schlüsselverschlüsselungsalgorithmus nicht unterstützt, muss sie FALSE zurückgeben und SetLastError mit ERROR_NOT_SUPPORTED aufrufen.
Hinweise
Die CryptMsgControl-Funktion ruft diese Funktion für die folgenden Vorgänge auf, die durch den dwCtrlType-Parameter angegeben werden:
- CMSG_CTRL_DECRYPT
- CMSG_CTRL_KEY_TRANS_DECRYPT
- CMSG_CTRL_KEY_AGREE_DECRYPT
Sie können OID-Unterstützungsfunktionen verwenden, um diese Rückruffunktion bereitzustellen. Wincrypt.h definiert zu diesem Zweck die folgende Konstante.
| Dauerhaft | Definition |
|---|---|
| CMSG_OID_CNG_IMPORT_CONTENT_ENCRYPT_KEY_FUNC | "CryptMsgDllCNGImportContentEncryptKey" |
Beispiele
Ein Beispiel, das eine OID-installierbare Rückruffunktion bereitstellt, finden Sie unter Erweitern der CryptoAPI-Funktionalität.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wincrypt.h |