SslVerifySignature 関数

SslVerifySignature 関数は、指定されたハッシュと公開キーを使用して、指定された署名を検証します。

構文

SECURITY_STATUS WINAPI SslVerifySignature(
  _In_ NCRYPT_PROV_HANDLE hSslProvider,
  _In_ NCRYPT_KEY_HANDLE  hPublicKey,
  _In_ PBYTE              pbHashValue,
  _In_ DWORD              cbHashValue,
  _In_ PBYTE              pbSignature,
  _In_ DWORD              cbSignature,
  _In_ DWORD              dwFlags
);

パラメーター

hSslProvider [in]

Secure Sockets Layer プロトコル (SSL) プロトコル プロバイダー インスタンスへのハンドル。

hPublicKey [in]

公開キーのハンドル。

pbHashValue [in]

署名の検証に使用するハッシュを含むバッファーへのポインター。

cbHashValue [in]

pbHashValue バッファーのサイズ (バイト単位)。

pbSignature [in]

検証する署名が格納されているバッファーへのポインター。

cbSignature [in]

pbSignature バッファーのサイズ (バイト単位)。

dwFlags [in]

このパラメーターは将来使用するために予約されています。

戻り値

関数が成功すると、0 が返されます。

関数が失敗した場合は、0 以外のエラー値を返します。

可能なリターン コードには、次のものが含まれますが、これらに限定されません。

リターン コード/値	説明
NTE_INVALID_HANDLE 0x80090026L	指定されたハンドルの 1 つが無効です。

注釈

現在、SslVerifySignature 関数は Windows によって呼び出されていません。 この関数は SSL プロバイダー インターフェイスの必須部分であり、前方互換性を確保するために完全に実装する必要があります。

トランスポート層セキュリティ プロトコル (TLS) 接続のサーバー側の現在の実装では、クライアント認証中に NCryptVerifySignature 関数を呼び出して、証明書検証メッセージを処理します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
Header	Sslprovider.h
[DLL]	Ncrypt.dll