SslGenerateSessionKeys 関数

SslGenerateSessionKeys 関数は、一連の Secure Sockets Layer プロトコル (SSL) セッション キーを生成します。

構文

SECURITY_STATUS WINAPI SslGenerateSessionKeys(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  NCRYPT_KEY_HANDLE  hMasterKey,
  _Out_ NCRYPT_KEY_HANDLE  *phReadKey,
  _Out_ NCRYPT_KEY_HANDLE  *phWriteKey,
  _In_  PNCryptBufferDesc  pParameterList,
  _In_  DWORD              dwFlags
);

パラメーター

hSslProvider [in]

SSL プロトコル プロバイダー インスタンスへのハンドル。

hMasterKey [in]

マスター キー オブジェクトへのハンドル。

phReadKey [out]

返された読み取りキー ハンドルへのポインター。

phWriteKey [out]

返された書き込みキー ハンドルへのポインター。

pParameterList [in]

キー交換操作の一部として使用される情報を含む NCryptBuffer バッファーの配列へのポインター。 バッファーの正確なセットは、使用されるプロトコルと暗号スイートに依存します。 少なくとも、リストには、クライアントとサーバーが指定したランダムな値を含むバッファーが含まれます。

dwFlags [in]

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

戻り値

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

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

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

リターン コード/値	説明
NTE_NO_MEMORY 0x8009000EL	必要なバッファーを割り当てるのに十分なメモリがありません。
NTE_INVALID_HANDLE 0x80090026L	指定されたハンドルの 1 つが無効です。
NTE_INVALID_PARAMETER 0x80090027L	phReadKey または phWriteKey パラメーターが null です。

要件

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