SslLookupCipherLengths 関数

SslLookupCipherLengths 関数は、入力プロトコル、暗号スイート、およびキー型のヘッダーとトレーラーの長さを含むNCRYPT_SSL_CIPHER_LENGTHS構造体を返します。

構文

SECURITY_STATUS WINAPI SslLookupCipherLengths(
  _In_  NCRYPT_PROV_HANDLE        hSslProvider,
  _In_  DWORD                     dwProtocol,
  _In_  DWORD                     dwCipherSuite,
  _In_  DWORD                     dwKeyType,
  _Out_ NCRYPT_SSL_CIPHER_LENGTHS *pCipherLengths,
  _In_  DWORD                     cbCipherLengths,
  _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 に設定します。

pCipherLengths [out]

NCRYPT_SSL_CIPHER_LENGTHS構造体を受け取るバッファーへのポインター。

cbCipherLengths [in]

pCipherLengths パラメーターが指すバッファーの長さ (バイト単位)。

dwFlags [in]

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

戻り値

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

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

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

リターン コード/値	説明
NTE_INVALID_HANDLE 0x80090026L	hSslProvider パラメーターには、無効なポインターが含まれています。
NTE_INVALID_PARAMETER 0x80090027L	pCipherLengths パラメーターが NULL に設定されているか、cbCipherLengths で指定されたバッファー長が短すぎます。
NTE_BAD_FLAGS 0x80090009L	dwFlags パラメーターは 0 に設定する必要があります。

注釈

SslLookupCipherLengths 関数は、トランスポート層セキュリティ プロトコル (TLS) 1.1 以降の会話に対して呼び出され、要求されたプロトコル、暗号スイート、およびキーの種類のヘッダーとトレーラーの長さを照会します。

要件

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