SslGetProviderProperty 関数

SslGetProviderProperty 関数は、指定されたプロバイダー プロパティの値を取得します。

構文

SECURITY_STATUS WINAPI SslGetProviderProperty(
  _In_    NCRYPT_PROV_HANDLE hSslProvider,
  _In_    LPCWSTR            pszProperty,
  _Out_   PBYTE              ppbOutput,
  _Out_   DWORD              *pcbOutput,
  _Inout_ PVOID              *ppEnumState,
  _In_    DWORD              dwFlags
);

パラメーター

hSslProvider [in]

プロパティを取得 する Secure Sockets Layer プロトコル (SSL) プロバイダーのハンドル。

pszProperty [in]

取得するプロパティの名前を含む null で終わる Unicode 文字列へのポインター。

ppbOutput [out]

プロパティ値を受け取るバッファーのアドレス。

関数の呼び出し元は、 SslFreeBuffer 関数を呼び出してこのバッファーを解放する必要があります。

pcbOutput [out]

pbOutput バッファーのサイズ (バイト単位)。

ppEnumState [in, out]

この関数の後続の呼び出しで使用される列挙状態情報を受け取る VOID ポインターのアドレス。 この情報は SSL プロバイダーにとってのみ意味があり、呼び出し元には不透明です。 SSL プロバイダーは、この情報を使用して、列挙体の次の項目を決定します。 このパラメーターが指す変数に NULL が含まれている場合、列挙は最初から開始されます。

関数の呼び出し元は、 SslFreeBuffer 関数を呼び出して、このメモリを解放する必要があります。

dwFlags [in]

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

戻り値

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

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

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

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

要件

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