LPWSCWRITEPROVIDERORDER

WSCWriteProviderOrder 関数は、利用可能なトランスポートプロバイダーの順序を変更するために使用します。プロトコルの順序は、列挙されるときや使用するために選択されるときのプロトコルの優先度を決定します。

この関数は、処理に成功した場合は ERROR_SUCCESS（ゼロ）を返します。それ以外の場合は、固有のエラーコードを返します。

トランスポートサービスプロバイダーが最初にインストールされた順序によって、サービスプロバイダーインターフェイスの WSCEnumProtocols、またはアプリケーションインターフェイスの WSAEnumProtocols で列挙される順序が決まります。さらに重要な点として、この順序は、クライアントがアドレスファミリー、種類、プロトコル識別子に基づいてソケットの作成を要求したときに、どのプロトコルとサービスプロバイダーが検討されるかの順序も決定します。

Windows Sockets 2 には Sporder.exe というアプリケーションが含まれており、プロトコルのインストール後に、インストール済みプロトコルのカタログを対話的に並べ替えることができます。また Windows Sockets 2 には補助 DLL の Sporder.dll も含まれており、プロトコルを並べ替えるためのこの手続き型インターフェイスをエクスポートします。このインターフェイスは Sporder.lib をリンクすることでインポートできます。

次のような場合に、 WSCWriteProviderOrder 関数は失敗することがあります。

• dwNumberOfEntries パラメーターが、登録されたサービスプロバイダーの数と一致しない。
• lpwdCatalogEntryId に無効なカタログ識別子が含まれている。
• lpwdCatalogEntryId に、すべての有効なカタログ識別子がそれぞれちょうど 1 回ずつ含まれていない。
• 何らかの理由（ユーザーの権限が不十分であるなど）でレジストリにアクセスできない。
• 別のプロセス（またはスレッド）が現在この関数を呼び出している。

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

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