SslCreateClientAuthHash 関数

SslCreateClientAuthHash 関数は、クライアント認証に使用されるハンドシェイク ハッシュへのハンドルを取得します。

構文

SECURITY_STATUS WINAPI SslCreateClientAuthHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_HASH_HANDLE *phHandshakeHash,
  _In_  DWORD              dwProtocol,
  _In_  DWORD              dwCipherSuite,
  _In_  LPCWSTR            pszHashAlgId,
  _In_  DWORD              dwFlags
);

パラメーター

hSslProvider [in]

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

phHandshakeHash [out]

ハッシュ ハンドルを受け取る NCRYPT_HASH_HANDLE 変数へのポインター。

dwProtocol [in]

CNG SSL プロバイダー プロトコル識別子の値の 1 つ。

dwCipherSuite [in]

CNG SSL プロバイダー暗号スイート識別子の値の 1 つ。

pszHashAlgId [in]

CNG アルゴリズム識別子の値の 1 つ。

dwFlags [in]

このパラメーターは将来使用するために予約されており、0 に設定する必要があります。

戻り値

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

関数が失敗すると、0 以外のエラー値が返されます。

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

リターン コード/値	説明
NTE_INVALID_HANDLE 0x80090026L	hSslProvider パラメーターには、無効なポインターが含まれています。
NTE_INVALID_PARAMETER 0x80090027L	phHandshakeHash パラメーターは NULL に設定されています。
NTE_NOT_SUPPORTED 0x80090029L	選択した関数は、指定されたバージョンのインターフェイスではサポートされていません。
NTE_NO_MEMORY 0x8009000EL	バッファーを割り当てるメモリが不足しています。
NTE_BAD_FLAGS 0x80090009L	dwFlags パラメーターは 0 に設定する必要があります。

注釈

SslCreateClientAuthHash 関数は、トランスポート層セキュリティ プロトコル (TLS) 1.2 以降の会話に対して呼び出され、ハンドシェイク メッセージのハッシュに使用されるハッシュ オブジェクトを作成します。 これは、クライアント認証署名で使用できる ハッシュ アルゴリズム ごとに 1 回呼び出されます。

必要条件

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