RpcNsBindingUnexportPnPW 関数 (rpcnsi.h)
RpcNsBindingUnexportPnP 関数は、プラグ アンド プレイ インターフェイスとオブジェクトのバインド ハンドルをネーム サービス データベースのエントリから削除します。
構文
RPC_STATUS RpcNsBindingUnexportPnPW(
unsigned long EntryNameSyntax,
RPC_WSTR EntryName,
RPC_IF_HANDLE IfSpec,
UUID_VECTOR *ObjectVector
);
パラメーター
EntryNameSyntax
EntryName の構文。
HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxレジストリ 値エントリで 指定された構文を使用するには、 の値を指定RPC_C_NS_SYNTAX_DEFAULT。
EntryName
バインド ハンドルとオブジェクト UUID を削除するエントリ名へのポインター。
IfSpec
名前サービス データベースから削除されるバインド ハンドルのインターフェイス指定。 null パラメーター値は、バインド ハンドルのエクスポートを解除しないことを示します (エクスポート解除されるのはオブジェクト UUID のみです)。
ObjectVector
サーバーが提供しなくなったオブジェクト UUID のベクトルへのポインター。 アプリケーションはこのベクトルを構築します。 null 値は、エクスポート解除するオブジェクト UUID がないことを示します (バインド ハンドルのみがエクスポート解除されます)。
戻り値
値 | 説明 |
---|---|
|
呼び出しは成功しました。 |
|
バージョン オプションが無効です。 |
|
名前の構文が無効です。 |
|
名前の構文はサポートされていません。 |
|
名前が不完全です。 |
|
name-service エントリが見つかりませんでした。 |
|
名前サービスを利用できません。 |
|
インターフェイスが見つかりませんでした。 |
|
すべてのオブジェクトがエクスポートされていないわけではありません。 |
解説
RpcNsBindingUnexportPnP 関数を使用すると、サーバー アプリケーションは、プラグ アンド プレイ互換リソースのバインド ハンドルとオブジェクト UUID をネーム サービス データベース エントリから削除できます。 サーバー アプリケーションは、 RpcNsBindingUnexportPnP の 1 回の呼び出しで指定されたインターフェイスとオブジェクトのエクスポートを解除することも、個別にエクスポート解除することもできます。 IfSpec パラメーターで見つかった、インターフェイス UUID とメジャー およびマイナー インターフェイスのバージョン番号に一致するバインド ハンドルのみがエクスポートされません。
注意
rpcnsi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RpcNsBindingUnexportPnP を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | rpcnsi.h (Rpc.h を含む) |
Library | Rpcns4.lib |
[DLL] | Rpcns4.dll |