WSCUnInstallNameSpace32 関数 (ws2spi.h)

  • [アーティクル]

WSCUnInstallNameSpace32 関数は、特定の 32 ビット名前空間プロバイダーをアンインストールします。

メモ この呼び出しは、64 ビット プラットフォームで使用する WSCUnInstallNameSpace の厳密な 32 ビット バージョンです。 64 ビット プロセスが 32 ビット カタログにアクセスできるように提供されています。

 

構文

INT WSCUnInstallNameSpace32(
  [in] LPGUID lpProviderId
);

パラメーター

[in] lpProviderId

アンインストールするネームスペース プロバイダーのグローバル一意識別子 (GUID) へのポインター。

戻り値

エラーが発生しない場合、 WSCUnInstallNameSpace32 は NO_ERROR (ゼロ) を返します。 それ以外の場合、関数が失敗した場合は SOCKET_ERROR が返され、 WSAGetLastError 関数を使用して適切なエラー コードを取得する必要があります。

エラー コード 意味
WSAEFAULT
 lpProviderId パラメーターは、ユーザー アドレス空間の有効な部分にないメモリを指します。
WSAEINVAL
 指定された名前空間プロバイダー識別子が無効です。
WSASYSCALLFAILURE
 失敗しないシステム呼び出しが失敗しました。
WSA_NOT_ENOUGH_MEMORY
 メモリが不足していました。 このエラーは、新しいカタログ エントリを割り当てるためのメモリが不足している場合に返されます。

解説

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

名前空間構成関数は、既に実行されているアプリケーションには影響しません。 新しくインストールされたネームスペース プロバイダーは、アプリケーションに対して表示されず、ネームスペース プロバイダーのアクティブ化状態の変更も表示されません。 WSCUnInstallNameSpace32 の呼び出し後に起動されたアプリケーションは、変更を認識します。

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

WSCUnInstallNameSpace32 関数は、Administrators グループのメンバーとしてログオンしているユーザーのみが呼び出すことができます。 Administrators グループのメンバーではないユーザーによって WSCUnInstallNameSpace32 が呼び出された場合、関数呼び出しは失敗し、lpErrno パラメーターでWSANO_RECOVERYが返されます。

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

この関数の呼び出し元は、サービス プロバイダーを完全にアンインストールするために必要な追加のファイルまたはサービス プロバイダー固有の構成情報を削除する必要があります。

要件

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

関連項目

WSAProviderConfigChange

WSCDeinstallProvider32

WSCEnumProtocols32

WSCInstallNameSpace32

WSCUnInstallNameSpace