PFN_CMSG_IMPORT_KEY_TRANS Rückruffunktion (wincrypt.h)

Artikel
03/03/2024

Die PFN_CMSG_IMPORT_KEY_TRANS Rückruffunktion importiert einen Inhaltsverschlüsselungsschlüssel für einen Schlüsseltransportempfänger einer umhüllten Nachricht. PFN_CMSG_IMPORT_KEY_TRANS können mithilfe eines CryptoAPI-Objektbezeichners installiert werden. Diese Funktion wird von der CryptMsgControl-Funktion aufgerufen, wenn der dwCtrlType-Parameter auf CMSG_CTRL_DECRYPT festgelegt ist.

Syntax

PFN_CMSG_IMPORT_KEY_TRANS PfnCmsgImportKeyTrans;

BOOL PfnCmsgImportKeyTrans(
  [in]  PCRYPT_ALGORITHM_IDENTIFIER pContentEncryptionAlgorithm,
  [in]  PCMSG_CTRL_KEY_TRANS_DECRYPT_PARA pKeyTransDecryptPara,
  [in]  DWORD dwFlags,
        void *pvReserved,
  [out] HCRYPTKEY *phContentEncryptKey
)
{...}

Parameter

[in] pContentEncryptionAlgorithm

Ein Zeiger auf eine CRYPT_ALGORITHM_IDENTIFIER-Struktur , die den Algorithmus angibt, der zum Verschlüsseln des Nachrichteninhalts und aller zugeordneten Parameter verwendet wird.

[in] pKeyTransDecryptPara

Ein Zeiger auf eine CMSG_CTRL_KEY_TRANS_DECRYPT_PARA Struktur, die Informationen zum Schlüsseltransportempfänger enthält.

[in] dwFlags

Dieser Wert wird nicht verwendet. Legen Sie ihn auf 0 (null) fest.

pvReserved

Dieser Parameter ist reserviert und muss NULL sein.

[out] phContentEncryptKey

Die Adresse eines Handles für den Inhaltsverschlüsselungsschlüssel, der von dieser Funktion zurückgegeben wird.

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 E_NOTIMPL aufrufen.

Hinweise

Sie können OID-Unterstützungsfunktionen verwenden, um diese Rückruffunktion bereitzustellen. Wincrypt.h definiert zu diesem Zweck die folgenden Konstanten.

Dauerhaft	Definition
CMSG_OID_IMPORT_KEY_TRANS_FUNC oder CMSG_OID_CAPI1_IMPORT_KEY_TRANS_FUNC	"CryptMsgDllImportKeyTrans"

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wincrypt.h

Share via