WSCWriteProviderOrder32 関数 (sporder.h)
WSCWriteProviderOrder32 関数は、使用可能な 32 ビット トランスポート プロバイダーの順序を変更するために使用されます。 プロトコルの順序によって、使用するプロトコルの列挙または選択時のプロトコルの優先順位が決まります。
構文
int WSCWriteProviderOrder32(
[in] LPDWORD lpwdCatalogEntryId,
[in] DWORD dwNumberOfEntries
);
パラメーター
[in] lpwdCatalogEntryId
WSAPROTOCOL_INFO構造体にある CatalogEntryId 要素の配列へのポインター。 CatalogEntryId 要素の順序は、プロトコルの新しい優先順位です。
[in] dwNumberOfEntries
lpwdCatalogEntryId 配列内の要素の数。
戻り値
ルーチンが成功した場合、関数は ERROR_SUCCESS (ゼロ) を返します。 それ以外の場合は、特定のエラー コードを返します。
| エラー コード | 意味 |
|---|---|
| 1 つ以上の引数が無効です。アクションは実行されませんでした。 | |
| 回復不可能なエラーが発生しました。 このエラーは、ユーザーが Winsock レジストリに書き込むのに必要な管理特権がない、またはカタログ エントリを開いたり書き込んだりするときにエラーが発生したなど、いくつかの条件で返されます。 | |
| メモリが不足していました。 このエラーは、新しいカタログ エントリを割り当てるメモリが不足している場合に返されます。 | |
|
ルーチンは、レジストリ エラー コードを返す場合があります。 |
注釈
WSCWriteProviderOrder32 関数は、WSCWriteProviderOrder 関数の厳密な 32 ビット バージョンです。 64 ビット コンピューターでは、特に 32 ビットではないすべての呼び出し (たとえば、"32" で終わっていないすべての関数) は、ネイティブの 64 ビット カタログで動作します。 64 ビット コンピューターで実行されるプロセスでは、特定の 32 ビット関数呼び出しを使用して、厳密に 32 ビット カタログで動作し、互換性を維持する必要があります。 特定の 32 ビット呼び出しの定義とセマンティクスは、ネイティブの呼び出しと同じです。
トランスポート サービス プロバイダーが最初にインストールされる順序は、サービス プロバイダー インターフェイスの WSCEnumProtocols32 またはアプリケーション インターフェイスの WSAEnumProtocols を介して列挙される順序を制御します。 さらに重要なのは、この順序は、クライアントがアドレス ファミリ、型、プロトコル識別子に基づいてソケットの作成を要求したときにプロトコルとサービス プロバイダーが考慮される順序も制御することです。
Windows Sockets 2 には、Sporder.exe と呼ばれるアプリケーションが含まれています。これにより、インストールされているプロトコルのカタログを、プロトコルが既にインストールされた後に対話形式で並べ替えることができます。 Windows Sockets 2 には、プロトコルの並べ替えのためにこの手続き型インターフェイスをエクスポートする補助 DLL Sporder.dll も含まれています。 このインターフェイスは、 Sporder.lib とリンクすることでインポートできます。
WSCWriteProviderOrder32 関数が失敗する可能性があるシナリオを次に示します。
- dwNumberOfEntries パラメーターは、登録済みサービス プロバイダーの数と等しくありません。
- lpwdCatalogEntryId に無効なカタログ識別子が含まれています。
- lpwdCatalogEntryId には、有効なすべてのカタログ識別子が 1 回のみ含まれているわけではありません。
- ルーチンは何らかの理由でレジストリにアクセスできません (たとえば、ユーザーのアクセス許可が不十分です)。
- 別のプロセス (またはスレッド) が現在関数を呼び出しています。
成功すると、 WSCWriteProviderOrder32 は 、WSAProviderConfigChange を呼び出して、変更の通知を登録したすべての関心のあるアプリケーションにアラートを送信しようとします。
WSCWriteProviderOrder32 関数は、Administrators グループのメンバーとしてログオンしているユーザーのみが呼び出すことができます。 Administrators グループのメンバーではないユーザーが WSCWriteProviderOrder32 を呼び出すと、関数呼び出しは失敗し、 WSANO_RECOVERY が返されます。 Windows Vista または Windows Server 2008 で実行されているコンピューターの場合、この関数はユーザー アカウント制御 (UAC) のために失敗する可能性もあります。 この関数を含むアプリケーションが、組み込みの Administrator 以外の Administrators グループのメンバーとしてログオンしているユーザーによって実行された場合、 requestedExecutionLevel が requireAdministrator に設定されたマニフェスト ファイルでアプリケーションがマークされていない限り、この呼び出しは失敗します。 Windows Vista または Windows Server 2008 上のアプリケーションにこのマニフェスト ファイルがない場合、組み込みの Administrator 以外の Administrators グループのメンバーとしてログオンしたユーザーは、この関数を成功させるために、拡張シェルで組み込みの Administrator (RunAs 管理者) としてアプリケーションを実行する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista、Windows XP Professional x64 Edition [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008、Windows Server 2003 x64 Edition [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | sporder.h |
| Library | Sporder.lib |
| [DLL] | Ws2_32.dll |
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示