WSCInstallNameSpaceEx

ネームスペースプロバイダをインストールする。(WSCInstallNameSpaceEx)

WSCInstallNameSpaceEx lpszIdentifier, lpszPathName, dwNameSpace, dwVersion, lpProviderId, lpProviderSpecific

lpszIdentifier : [wstr] lpProviderId の GUID に関連付けられたプロバイダを識別する文字列へのポインタ。
lpszPathName : [wstr] プロバイダ DLL へのロードパスを含む Unicode 文字列へのポインタ。通常のパス解決規則に従い、%SystemRoot% などの埋め込み環境変数文字列を含めてよい。埋め込み環境変数文字列は、Ws2_32.dll がアプリケーションのためにプロバイダ DLL をロードするときに展開される。展開後、Ws2_32.dll は結果の文字列を LoadLibrary に渡してプロバイダをメモリにロードする。詳しくは **LoadLibrary** を参照。
dwNameSpace : [int] このプロバイダがサポートする名前空間。
dwVersion : [int] プロバイダのバージョン番号。
lpProviderId : [var] プロバイダの GUID へのポインタ。この GUID は Uuidgen.exe で生成すべきである。
lpProviderSpecific : [var] 名前空間エントリに関連付けられたプロバイダ固有データブロブ。

(プラグイン / モジュール : ws2_32.dll)

解説

ネームスペースプロバイダをインストールする。(WSCInstallNameSpaceEx)

[戻り値]
エラーがない場合、**WSCInstallNameSpaceEx** は **NO_ERROR** (0) を返す。関数が失敗すると
**SOCKET_ERROR** が返され、WSAGetLastError で適切なエラーコードを取得しなければならない。
このドキュメントは省略されている。

[備考]

名前空間構成関数はすでに実行中のアプリケーションには影響しない。新規インストールされたネームスペースプロバイダや状態変化はアプリケーションからは見えず、**WSCInstallNameSpaceEx**
呼び出し後に起動されたアプリケーションにのみ変更が反映される。lpProviderInfo
引数で渡される名前空間エントリ関連のプロバイダ固有データブロブは、WSAEnumNameSpaceProvidersEx
で問い合わせ可能である。Windows に同梱されているネームスペースプロバイダで lpProviderInfo を使うのは
NS_EMAIL プロバイダのみである。NS_EMAIL のデータブロブは NAPI_PROVIDER_INSTALLATION_BLOB
構造体である。**WSCInstallNameSpaceEx** は Administrators
グループのメンバとしてログオンしているユーザーのみが呼び出せる。そうでない場合は失敗する。Windows Vista や Windows
Server 2008 では UAC が原因で失敗することもある。マニフェストで **requireAdministrator**
を設定していない場合、組み込み Administrator 以外の Administrators メンバは RunAs
administrator で実行する必要がある。

情報