KspVerifySignatureFn コールバック関数 (ntsecpkg.h)

  • [アーティクル]

受信したメッセージが署名に従って正しいことを確認 します。

SpVerifySignature 関数は、セキュリティ サポート プロバイダー インターフェイスの VerifySignature 関数のディスパッチ関数です。

構文

KspVerifySignatureFn Kspverifysignaturefn;

NTSTATUS Kspverifysignaturefn(
        LSA_SEC_HANDLE ContextId,
  [in]  PSecBufferDesc Message,
  [in]  ULONG MessageSeqNo,
  [out] PULONG pfQOP
)
{...}

パラメーター

ContextId

[in] Message

確認するメッセージを含む SecBufferDesc 構造体へのポインター。

[in] MessageSeqNo

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

[out] pfQOP

保護の品質を示すパッケージ固有のフラグへのポインター。

戻り値

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

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

リターン コード 説明
SEC_E_INVALID_HANDLE
 ハンドルが無効です。

注釈

SpVerifySignature 関数によって検証された署名は、メッセージ送信者によって使用される SpMakeSignature 関数によって作成されます。

SSP/AP は SpVerifySignature 関数を実装する必要があります。ただし、実装に与えられる実際の名前は開発者次第です。

SpVerifySignature 関数へのポインターは、SpUserModeInitialize 関数から受信したSECPKG_USER_FUNCTION_TABLE構造体で使用できます。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー ntsecpkg.h

こちらもご覧ください

MakeSignature

SECPKG_USER_FUNCTION_TABLE

SpMakeSignature

SpUserModeInitialize

VerifySignature