SslGetCipherSuitePRFHashAlgorithm 関数

  • [アーティクル]

SslGetCipherSuitePRFHashAlgorithm 関数は、入力プロトコル、暗号スイート、キーの種類に対してトランスポート層セキュリティ プロトコル (TLS) 擬似ランダム関数 (PRF) に使用されるハッシュ アルゴリズムの Cryptography API: Next Generation (CNG) Algorithm Identifier を返します。

構文

SECURITY_STATUS WINAPI SslGetCipherSuitePRFHashAlgorithm(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  DWORD              dwProtocol,
  _In_  DWORD              dwCipherSuite,
  _In_  DWORD              dwKeyType,
  _Out_ WCHAR              szPRFHash[NCRYPT_SSL_MAX_NAME_SIZE],
  _In_  DWORD              dwFlags
);

パラメーター

hSslProvider [in]

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

dwProtocol [in]

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

dwCipherSuite [in]

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

dwKeyType [in]

CNG SSL プロバイダー のキー型識別子の値の 1 つ。 楕円曲線暗号化 (ECC) ではないキー型の場合は、このパラメーターを 0 に設定します。

szPRFHash [out]

TLS PRF に使用されるハッシュの CNG アルゴリズム識別子 の 1 つ。

dwFlags [in]

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

戻り値

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

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

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

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

注釈

この SslGetCipherSuitePRFHashAlgorithm 関数は、TLS PRF で使用されるハッシュ アルゴリズムに対してクエリを実行するために、TLS 1.2 以降の会話に対して呼び出されます。

要件

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