PFN_CMSG_IMPORT_KEY_AGREE Rückruffunktion (wincrypt.h)

Artikel
07/16/2024

Die PFN_CMSG_IMPORT_KEY_AGREE Rückruffunktion importiert einen Inhaltsverschlüsselungsschlüssel für einen Schlüsseltransportempfänger einer umschlägen Nachricht. PFN_CMSG_IMPORT_KEY_AGREE können mithilfe einer CryptoAPI Objektbezeichner (OID) installiert werden. Diese Funktion wird von der CryptMsgControl--Funktion aufgerufen, wenn der dwCtrlType Parameter auf CMSG_CTRL_DECRYPTfestgelegt ist.

Syntax

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
)
{...}

Parameter

[in] pContentEncryptionAlgorithm

Ein Zeiger auf eine CRYPT_ALGORITHM_IDENTIFIER Struktur, die den Algorithmus angibt, mit dem der Nachrichteninhalt und alle zugehörigen Parameter verschlüsselt werden.

[in] pKeyAgreeDecryptPara

Ein Zeiger auf eine CMSG_CTRL_KEY_AGREE_DECRYPT_PARA-Struktur, die Informationen zum Empfänger der wichtigsten Vereinbarung enthält.

[in] dwFlags

Dieser Wert wird nicht verwendet. Legen Sie sie auf Null fest.

pvReserved

Dieser Parameter ist reserviert und muss NULL-sein.

[out] phContentEncryptKey

Die Adresse eines Handles für den von dieser Funktion zurückgegebenen Inhaltsverschlüsselungsschlüssel.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null (TRUE).

Wenn die Funktion fehlschlägt, ist der Rückgabewert null (FALSE). Rufen Sie für erweiterte Fehlerinformationen GetLastError-auf.

Wenn diese Rückruffunktion den Schlüsselverschlüsselungsalgorithmus nicht unterstützt, muss sie FALSE- zurückgeben und SetLastError- mit E_NOTIMPLaufrufen.

Bemerkungen

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

Konstante	Definition
CMSG_OID_IMPORT_KEY_AGREE_FUNC oder CMSG_OID_CAPI1_IMPORT_KEY_AGREE_FUNC	"CryptMsgDllImportKeyAgree"

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wincrypt.h

Freigeben über