SslOpenProvider 関数

  • [アーティクル]

SslOpenProvider 関数は、指定された Secure Sockets Layer プロトコル (SSL) プロトコル プロバイダーへのハンドルを開きます。

構文

SECURITY_STATUS WINAPI SslOpenProvider(
  _Out_ NCRYPT_PROV_HANDLE *phSslProvider,
  _In_  LPCWSTR            pszProviderName,
  _In_  DWORD              dwFlags
);

パラメーター

phSslProvider [out]

プロバイダー ハンドルを記述する NCRYPT_PROV_HANDLE のアドレス。

ハンドルの使用が完了したら、 SslFreeObject 関数を呼び出してハンドルを解放する必要があります。

pszProviderName [in]

プロバイダー名を含む Unicode 文字列へのポインター。 このパラメーターの値が NULL の場合は、 MS_SCHANNEL_PROVIDER へのハンドルが返されます。

dwFlags [in]

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

戻り値

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

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

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

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

必要条件

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