SslCreateHandshakeHash 関数

  • [アーティクル]

SslCreateHandshakeHash 関数は、ハンドシェイク メッセージをハッシュするために使用されるハッシュ ハンドルを取得します。

構文

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

パラメーター

hSslProvider [in]

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

phHandshakeHash [out]

他の SSL プロバイダー関数に渡すことができるハッシュ ハンドル。

dwProtocol [in]

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

注意

この関数は、SSL 2.0 プロトコルでは使用されません。

dwCipherSuite [in]

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

dwFlags [in]

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

戻り値

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

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

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

リターン コード/値 説明
NTE_NO_MEMORY
0x8009000EL
 ハッシュ バッファーを割り当てるためのメモリが不足しています。
NTE_INVALID_HANDLE
0x80090026L
 hSslProvider ハンドルが無効です。
NTE_INVALID_PARAMETER
0x80090027L
 phHandshakeHash が null です。

注釈

SslCreateHandshakeHash 関数は、SSL ハンドシェイク中に使用するハッシュを生成するために使用される 3 つの関数のうちの 1 つです。

  1. SslCreateHandshakeHash 関数は、ハッシュ ハンドルを取得するために呼び出されます。
  2. SslHashHandshake 関数は、ハッシュ ハンドルを使用して任意の回数呼び出され、ハッシュにデータを追加します。
  3. SslComputeFinishedHash 関数は、ハッシュ されたデータのダイジェストを取得するために、ハッシュ ハンドルと共に呼び出されます。

要件

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