WSCUnInstallNameSpace 関数 (ws2spi.h)

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

構文

INT WSCUnInstallNameSpace(
  [in] LPGUID lpProviderId
);

パラメーター

[in] lpProviderId

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

戻り値

エラーが発生しない場合、 WSCUnInstallNameSpaceNO_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 グループのメンバーとしてログオンしているユーザーによって実行された場合、 requestedExecutionLevelrequireAdministrator に設定されたマニフェスト ファイルでアプリケーションがマークされていない限り、この呼び出しは失敗します。 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

こちらもご覧ください

WSAProviderConfigChange

WSCDeinstallProvider

WSCEnumProtocols

WSCInstallNameSpace

WSCUnInstallNameSpace32