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