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

KspMakeSignatureFn

コールバック

シグネチャ

NTSTATUS KspMakeSignatureFn(
    UINT_PTR ContextId,
    DWORD fQOP,
    SecBufferDesc* Message,
    DWORD MessageSeqNo
);

パラメーター

フィールド型説明
ContextIdUINT_PTRメッセージの署名を生成するために使用するセキュリティコンテキストへのハンドル。
fQOPDWORD保護の品質を示す、パッケージ固有のフラグを指定します。セキュリティパッケージは、このパラメーターを使用して暗号アルゴリズムの選択をサポートできます
MessageSecBufferDesc*SecBuffer 構造体へのポインター。入力時、この構造体には署名対象のメッセージが格納されています。
MessageSeqNoDWORD

メッセージに割り当てるシーケンス番号。シーケンス番号は省略可能であり、メッセージの消失や挿入に対する保護として使用されます。値が 0 の場合は、シーケンス番号を使用しないことを示します。

- MessageBuffers

公式ドキュメント

SpMakeSignature 関数は、指定されたメッセージとセキュリティコンテキストに基づいて署名を生成します。

SpMakeSignature 関数は、 Security Support Provider Interface の MakeSignature 関数のディスパッチ関数です。

戻り値

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

関数が失敗した場合は、失敗した理由を示す NTSTATUS コードを返します。次に、一般的な失敗の理由と、関数が返すべきエラーコードを示します。

戻り値 説明
SEC_E_INVALID_HANDLE
 ハンドルが無効です。

解説(Remarks)

SpMakeSignature 関数に対応するのは SpVerifySignature 関数で、受信側で署名を検証するために使用されます。

SSP/AP は SpMakeSignature 関数を実装する必要がありますが、実装に付ける実際の名前は開発者が決定します。

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

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