CryptMsgDuplicate 関数 (wincrypt.h)

CryptMsgDuplicate 関数は、参照カウントをインクリメントすることによって、暗号化メッセージ ハンドルを複製します。

構文

HCRYPTMSG CryptMsgDuplicate(
  [in] HCRYPTMSG hCryptMsg
);

パラメーター

[in] hCryptMsg

重複する暗号化メッセージのハンドル。 重複は、メッセージの 参照カウント をインクリメントすることによって行われます。 メッセージのコピーは作成されません。

戻り値

返されるハンドルは、ハンドル入力と同じです。 メッセージのコピーは作成されません。 重複したメッセージ ハンドルの使用が完了したら、 CryptMsgClose 関数を呼び出して参照数を減らします。

解説

CryptMsgDuplicate は、実際にハンドルを解放するために CryptMsgClose への複数の呼び出しが必要になるように、HCRYPTMSG ハンドルの参照カウントを増やすために使用されます。

例

この関数を使用する例については、「 C プログラムの例: ハッシュされたメッセージのエンコードとデコード」を参照してください。

要件

サポートされている最小のクライアント	Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	wincrypt.h
Library	Crypt32.lib
[DLL]	Crypt32.dll

関連項目

CryptMsgClose

低レベルのメッセージ関数

簡略化されたメッセージ関数