WSCInstallProvider64_32関数 (ws2spi.h)

[アーティクル]
08/28/2023

[**WSCInstallProvider64_32** は、Windows Vista の時点で使用できなくなります。代わりに、 WSCInstallProvider または WSCInstallProviderAndChains を使用します。

WSCInstallProvider64_32関数は、指定されたトランスポートサービスプロバイダーを 64 ビットコンピューター上の 32 ビットおよび 64 ビットのシステム構成データベースにインストールします。

構文

int WSCInstallProvider64_32(
  [in]  LPGUID                    lpProviderId,
  [in]  const WCHAR               *lpszProviderDllPath,
  [in]  const LPWSAPROTOCOL_INFOW lpProtocolInfoList,
  [in]  DWORD                     dwNumberOfEntries,
  [out] LPINT                     lpErrno
);

パラメーター

[in] lpProviderId

プロバイダーのグローバル一意識別子 (GUID) へのポインター。

[in] lpszProviderDllPath

プロバイダー 64 ビット DLL への読み込みパスを含む Unicode 文字列へのポインター。この文字列は、パス解決の通常の規則を観察し、埋め込み環境文字列 (%SystemRoot%) を含めることができます。このような環境文字列は、Ws2_32.dll がアプリケーションの代わりにプロバイダー DLL を読み込む必要がある場合に展開されます。埋め込まれた環境文字列が展開されると、Ws2_32.dll は結果の文字列を LoadLibrary 関数に渡し、プロバイダーをメモリに読み込みます。詳細については、「 LoadLibrary」を参照してください。

[in] lpProtocolInfoList

WSAProtocol_Info構造体の配列へのポインター。各構造体は、プロバイダーによってサポートされるプロトコル、アドレスファミリ、ソケットの種類を定義します。

[in] dwNumberOfEntries

lpProtocolInfoList 配列内のエントリの数。

[out] lpErrno

関数が失敗した場合のエラーコードへのポインター。

戻り値

WSCInstallProvider64_32成功すると、0 が返されます。それ以外の場合は 、SOCKET_ERRORを返し、 lpErrno パラメーターで特定のエラーコードが返されます。

エラーコード	意味
WSAEFAULT	1 つ以上の引数がユーザー・アドレス・スペースの有効な部分にありません。
WSAEINVAL	1 つ以上の引数が無効です。
WSAENOBUFS	バッファーにメモリを割り当てませんでした。
WSANO_RECOVERY	回復不可能なエラーが発生しました。このエラーは、プロバイダーが既にインストールされている、ユーザーが Winsock レジストリに書き込むのに必要な管理特権がない、カタログエントリを作成またはインストールするときにエラーが発生した、など、いくつかの条件で返されます。
WSASYSCALLFAILURE	失敗しないシステム呼び出しが失敗しました。
WSA_NOT_ENOUGH_MEMORY	メモリが不足していました。このエラーは、新しいカタログエントリを割り当てるメモリが不足している場合に返されます。

注釈

WSCInstallProvider64_32 は、1 つのトランスポートサービスプロバイダーのみをインストールする WSCInstallProviderAndChains64_32 関数の基本バージョンです。 WSCInstallProvider64_32 を使用して、ベースプロトコル、階層化プロトコル、またはプロトコルチェーンをインストールできます。階層化サービスプロバイダーがインストールされている場合は、この関数を使用すると、 1 つの関数呼び出しで階層化プロトコルと 1 つ以上のプロトコルチェーンをインストールできるため、WSCInstallProviderAndChains64_32を使用する必要があります。 WSCInstallProvider64_32を使用して同じ作業を実行するには、各サービスプロバイダーコンポーネントをインストールするために複数の関数呼び出しが必要になります。

Windows ソケット (Winsock) 2 は、階層化されたプロトコルの概念に対応します。階層化されたプロトコルは、リモートエンドポイントとのデータの実際の交換に基づくトランスポートスタックに依存しながら、より高いレベルの通信機能のみを実装するプロトコルです。階層化されたプロトコルの例としては、認証を実行し、相互に合意された暗号化スキームを確立するためのプロトコルを接続確立プロセスに追加するセキュリティ層があります。このようなセキュリティプロトコルでは、一般に、TCP や SPX などの基になる信頼性の高いトランスポートプロトコルのサービスが必要になります。基本プロトコルという用語は、リモートエンドポイントとのデータ通信を完全に実行できる TCP や SPX などのプロトコルを指します。階層化プロトコルという用語は、スタンドアロンにできないプロトコルを記述するために使用されます。その後、プロトコルチェーンは、1 つ以上の階層化されたプロトコルとして定義され、ベースプロトコルによって連結され、固定されます。基本プロトコルには、WSAProtocol_Info 構造体の ChainLen メンバーが BASE_PROTOCOL に設定され、1 に定義されています。階層化プロトコルでは、WSAPROTOCOL_INFO構造体の ChainLen メンバーが LAYERED_PROTOCOL に設定され、ゼロとして定義されます。プロトコルチェーンには、WSAPROTOCOL_INFO構造体の ChainLen メンバーが 1 より大きく設定されています。

WSCInstallProvider64_32 は、64 ビットバージョンの WSCInstallProvider であり、64 ビットプラットフォーム上の 32 ビットカタログと 64 ビットカタログの両方にプロバイダーをインストールします。つまり、64 ビットプラットフォームでは、2 つの Winsock カタログが維持され、32 ビットプロセスと 64 ビットプロセスの両方で、この関数でインストールされているトランスポートプロバイダーを読み込むことができます。 64 ビットプラットフォームでは、 WSCInstallProvider は 64 ビット Winsock カタログにのみインストールします。

64 ビットコンピューターでは、32 ビット用に特別に設計されていないすべての呼び出し (たとえば、"32" で終わっていないすべての関数) は、ネイティブの 64 ビットカタログで動作します。 64 ビットコンピューターで実行されるプロセスでは、互換性を維持するために 、WSCInstallProvider64_32 を使用して 32 ビットカタログと 64 ビットカタログの両方で動作する必要があります。特定の 32 ビット呼び出しの定義とセマンティクスは、ネイティブの呼び出しと同じです。

このルーチンは、指定されたプロバイダーに必要な一般的な Winsock 2 構成情報を作成します。これは、ベースプロトコル、階層化されたプロトコル、プロトコルチェーンに適用されます。

lpProtocolInfoList パラメーターには、インストールするプロトコルエントリの一覧が含まれています。 WSCInstallProvider64_32の呼び出し元は、適切なプロトコルエントリを設定する責任があります。 lpProtocolInfoList パラメーターは NULL にすることはできません。

このルーチンが正常に完了すると、lpProtocolInfoList に指定されたプロトコル情報は、WSAEnumProtocols、WSCEnumProtocols、または WSCEnumProtocols32 によって返されます。 Windows では、この関数が正常に完了した後に WSAStartup を呼び出して作成された Ws2_32.dll のインスタンスにのみ、 WSAEnumProtocols、 WSCEnumProtocols、WSCEnumProtocols32 の新しいエントリが含まれることに注意してください。

メモWSAEnumProtocols 関数は、WSCEnumProtocols および WSCEnumProtocols32 が実行している間、階層化されたプロトコルエントリを列挙しません。

成功すると、 WSCInstallProvider64_32 は、WSAProviderConfigChange を呼び出して、変更の通知を登録したすべての関心のあるアプリケーションにアラートを送信しようとします。

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

ファイルのインストールまたはサービスプロバイダー固有の構成は、呼び出し元のアプリケーションによって実行する必要があります。

WSCInstallProvider または WSCInstallProviderAndChains 関数を使用する場合、32 ビットカタログにプロバイダーをインストールするには関数を 1 回呼び出し、64 ビットプラットフォームの 64 ビットカタログにプロバイダーをインストールするには 1 回呼び出す必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows XP Professional x64 Edition [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 x64 Edition [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	ws2spi.h
Library	Ws2_32.lib
[DLL]	Ws2_32.dll