WSCUnInstallNameSpace 関数 (ws2spi.h)

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

WSCUnInstallNameSpace 関数は、指定された名前空間プロバイダーをアンインストールします。

構文

INT WSCUnInstallNameSpace(
  [in] LPGUID lpProviderId
);

パラメーター

[in] lpProviderId

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

戻り値

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

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

注釈

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

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

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

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

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

要件

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