WSCDeinstallProvider32 関数 (ws2spi.h)

WSCDeinstallProvider32 関数は、指定された 32 ビット トランスポート プロバイダーをシステム構成データベースから削除します。

構文

int WSCDeinstallProvider32(
  [in]  LPGUID lpProviderId,
  [out] LPINT  lpErrno
);

パラメーター

[in] lpProviderId

プロバイダーのグローバル一意識別子 (GUID) へのポインター。 この値は、各WSAProtocol_Info構造体内 に 格納されます。

[out] lpErrno

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

戻り値

エラーが発生しない場合、 WSCDeinstallProvider32 は 0 を返します。 それ以外の場合は 、SOCKET_ERRORを返し、 lpErrno で特定のエラー コードを使用できます。

注釈

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

WSCDeinstallProvider32 関数は、指定された 32 ビット プロバイダーの一般的な Windows ソケット 2 構成情報を削除します。 このルーチンが正常に完了すると、レジストリに格納されている構成情報が変更されます。 ただし、現在メモリ内の Ws2_32.dll インスタンスは、この変更を認識できません。

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

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

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

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

要件

こちらもご覧ください

WSAProviderConfigChange

WSCDeinstallProvider

WSCEnumProtocols32

WSCInstallProvider64_32