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 |