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 以外のエラー値が返されます。
可能な戻りコードには、次のものが含まれますが、これらに限定されません。
| リターン コード/値 | 説明 |
|---|---|
|
hSslProvider パラメーターには、無効なポインターが含まれています。 |
|
pCipherLengths パラメーターが NULL に設定されているか、cbCipherLengths で指定されたバッファー長が短すぎます。 |
|
dwFlags パラメーターは 0 に設定する必要があります。 |
注釈
SslLookupCipherLengths 関数は、トランスポート層セキュリティ プロトコル (TLS) 1.1 以降の会話に対して呼び出され、要求されたプロトコル、暗号スイート、およびキーの種類のヘッダーとトレーラーの長さを照会します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2008 R2 [デスクトップ アプリのみ] |
| Header |
|
| [DLL] |
|