LPWSCINSTALLPROVIDER

WSCInstallProvider が成功した場合は 0 を返します。それ以外の場合は SOCKET_ERROR を返し、lpErrno パラメーターに固有のエラーコードが返されます。

WSCInstallProvider は、単一のトランスポートサービスプロバイダーをインストールするために使用します。このルーチンは、指定されたプロバイダーに必要な Windows Sockets 2 共通の構成情報を作成します。ベースプロトコル、レイヤードプロトコル、プロトコルチェーンのいずれにも適用できます。レイヤードサービスプロバイダーをインストールする場合は、WSCInstallProviderAndChains を使用してください。WSCInstallProviderAndChains は、1 回の関数呼び出しでレイヤードプロトコルと 1 つ以上のプロトコルチェーンをインストールできます。同じ作業を WSCInstallProvider で行うには、複数回の関数呼び出しが必要になります。

Winsock 2 はレイヤードプロトコルに対応しています。レイヤードプロトコルとは、上位レベルの通信機能だけを実装し、リモートエンドポイントとの実際のデータ交換は下位のトランスポートスタックに依存するプロトコルです。レイヤードプロトコルの例としては、認証を行い、相互に合意した暗号化方式を確立するために接続確立処理にプロトコルを追加するセキュリティレイヤーが挙げられます。このようなセキュリティプロトコルは、一般に TCP や SPX などの信頼性のある下位トランスポートプロトコルのサービスを必要とします。ベースプロトコルという用語は、TCP や SPX のようにリモートエンドポイントとのデータ通信を行えるプロトコルを指します。レイヤードプロトコルという用語は、単独では成立しないプロトコルを表すために使われます。そしてプロトコルチェーンは、1 つ以上のレイヤードプロトコルを連結し、ベースプロトコルで終端したものとして定義されます。 ベースプロトコルでは、WSAProtocol_Info 構造体の ChainLen メンバーに、1 と定義されている BASE_PROTOCOL が設定されます。レイヤードプロトコルでは、WSAPROTOCOL_INFO 構造体の ChainLen メンバーに、0 と定義されている LAYERED_PROTOCOL が設定されます。プロトコルチェーンでは、WSAPROTOCOL_INFO 構造体の ChainLen メンバーに 1 より大きい値が設定されます。

lpProtocolInfoList パラメーターには、インストールするプロトコルエントリの一覧を指定します。WSCInstallProvider の呼び出し側は、適切なプロトコルエントリを設定する責任を負います。lpProtocolInfoList パラメーターに NULL を指定することはできません。

この呼び出しが正常に完了すると、以降の WSAEnumProtocols または WSCEnumProtocols の呼び出しでは、新しく作成されたプロトコルエントリが返されます。なお、Windows 環境では、WSAEnumProtocols と WSCEnumProtocols が新しいエントリを返すのは、WSCInstallProvider が正常に完了した後に WSAStartup を呼び出して作成された Ws_32.dll のインスタンスに限られます。

成功した場合、WSCInstallProvider は WSAProviderConfigChange を呼び出して変更の通知を登録しているすべての関連アプリケーションに通知しようとします。

WSCInstallProvider 関数を呼び出せるのは、Administrators グループのメンバーとしてログオンしているユーザーだけです。Administrators グループのメンバーでないユーザーが WSCInstallProvider を呼び出した場合、関数呼び出しは失敗し、lpErrno パラメーターに WSANO_RECOVERY が返されます。 Windows Vista または Windows Server 2008 が動作しているコンピューターでは、ユーザーアカウント制御 (UAC) によってもこの関数が失敗することがあります。この関数を含むアプリケーションを、組み込み Administrator 以外の Administrators グループのメンバーとしてログオンしたユーザーが実行する場合、マニフェストファイルで requestedExecutionLevel に requireAdministrator が指定されていない限り、この呼び出しは失敗します。Windows Vista または Windows Server 2008 上のアプリケーションにこのマニフェストファイルがない場合、組み込み Administrator 以外の Administrators グループのメンバーとしてログオンしたユーザーは、組み込み Administrator として拡張されたシェル (管理者として実行) でアプリケーションを実行しなければ、この関数は成功しません。

ファイルのインストールやサービスプロバイダー固有の構成は、すべて呼び出し側で行う必要があります。