CryptMsgDuplicate-Funktion (wincrypt.h)

Die CryptMsgDuplicate-Funktion dupliziert ein Handle für kryptografische Nachrichten, indem die Verweisanzahl erhöht wird.

Syntax

HCRYPTMSG CryptMsgDuplicate(
  [in] HCRYPTMSG hCryptMsg
);

Parameter

[in] hCryptMsg

Handle der kryptografischen Nachricht, die dupliziert werden soll. Die Duplizierung erfolgt durch Inkrementieren der Verweisanzahl der Nachricht. Eine Kopie der Nachricht wird nicht erstellt.

Rückgabewert

Das zurückgegebene Handle entspricht der Handleeingabe. Eine Kopie der Nachricht wird nicht erstellt. Wenn Sie die Verwendung des duplizierten Nachrichtenhandles abgeschlossen haben, verringern Sie die Verweisanzahl, indem Sie die Funktion CryptMsgClose aufrufen.

Hinweise

CryptMsgDuplicate wird verwendet, um die Verweisanzahl für ein HCRYPTMSG-Handle zu erhöhen, sodass mehrere Aufrufe von CryptMsgClose erforderlich sind, um das Handle tatsächlich freizugeben.

Beispiele

Ein Beispiel, das diese Funktion verwendet, finden Sie unter Beispiel C-Programm: Codieren und Decodieren einer Hashnachricht.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincrypt.h
Bibliothek	Crypt32.lib
DLL	Crypt32.dll

Weitere Informationen

CryptMsgClose

Nachrichtenfunktionen auf niedriger Ebene

Vereinfachte Nachrichtenfunktionen