Win32 API 日本語リファレンス
ホーム › Security.Authentication.Identity › SpUnsealMessageFn

SpUnsealMessageFn

コールバック

シグネチャ

NTSTATUS SpUnsealMessageFn(
    UINT_PTR ContextHandle,
    SecBufferDesc* MessageBuffers,
    DWORD MessageSequenceNumber,
    DWORD* QualityOfProtection
);

パラメーター

フィールド型説明
ContextHandleUINT_PTRメッセージのシール (暗号化) に使用した セキュリティコンテキスト のハンドルです。
MessageBuffersSecBufferDesc*メッセージバッファーと署名バッファーを格納する SecBufferDesc 構造体へのポインターです。
MessageSequenceNumberDWORDメッセージに割り当てるシーケンス番号です。シーケンス番号は省略可能で、メッセージの消失や挿入に対する保護として使用されます。値が 0 の場合、シーケンス番号は使用されません。
QualityOfProtectionDWORD*使用されません。

公式ドキュメント

SpSealMessage 関数で以前に暗号化されたメッセージを復号します。

SpUnsealMessage 関数は、 Security Support Provider Interface の DecryptMessage (General) 関数に対応するディスパッチ関数です。

戻り値

関数が成功した場合は STATUS_SUCCESS を返します。

関数が失敗した場合は、失敗の理由を示す NTSTATUS コードを返します。

解説(Remarks)

SSP/AP は SpUnsealMessage 関数を実装する必要があります。ただし、実装に付ける実際の名前は開発者が自由に決められます。

SpUnsealMessage 関数へのポインターは、 SpUserModeInitialize 関数から受け取る SECPKG_USER_FUNCTION_TABLE 構造体から取得できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)