LPWSCUPDATEPROVIDER

WSCUpdateProvider 関数は、システム構成データベース内の、指定されたトランスポートプロバイダーを変更します。

エラーが発生しなかった場合、 WSCUpdateProvider はゼロを返します。それ以外の場合は SOCKET_ERROR を返し、具体的なエラーコードが lpErrno パラメーターに返されます。

WSCUpdateProvider 関数は、指定されたプロバイダーの Windows Sockets 2 構成情報を変更します。この関数は、ベースプロトコル、階層化プロトコル、プロトコルチェーンのいずれにも適用できます。

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

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

WSCUpdateProvider 関数は、Administrators グループのメンバーとしてログオンしているユーザーだけが呼び出せます。Administrators グループのメンバーでないユーザーが WSCUpdateProvider を呼び出した場合、この関数呼び出しは失敗します。

Windows Vista または Windows Server 2008 で実行しているコンピューターでは、ユーザーアカウント制御 (UAC) が原因でこの関数が失敗することもあります。この関数を含むアプリケーションを、組み込みの Administrator 以外の Administrators グループのメンバーとしてログオンしているユーザーが実行した場合、アプリケーションのマニフェストファイルで requestedExecutionLevel に requireAdministrator が指定されていない限り、この呼び出しは失敗します。Windows Vista または Windows Server 2008 でアプリケーションにこのマニフェストファイルがない場合、組み込みの Administrator 以外の Administrators グループのメンバーとしてログオンしているユーザーは、この関数を成功させるために、組み込みの Administrator として昇格したシェル (管理者として実行) でアプリケーションを実行する必要があります。

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