RpcMgmtEpUnregister 関数 (rpcdce.h)
[この関数は、Windows NTと Windows Me/98/95 でのみサポートされています。他のバージョンの Windows ではEP_S_CANT_PERFORM_OPが返されます。
RpcMgmtEpUnregister 関数は、エンドポイント マップからサーバー アドレス情報を削除します。
構文
RPC_STATUS RpcMgmtEpUnregister(
RPC_BINDING_HANDLE EpBinding,
RPC_IF_ID *IfId,
RPC_BINDING_HANDLE Binding,
UUID *ObjectUuid
);
パラメーター
EpBinding
エンドポイント マップ要素を登録解除するホスト。 呼び出し元のアプリケーションと同じホストから要素を削除するために、アプリケーションは NULL の値を指定します。 別のホストから要素を削除するために、アプリケーションは、そのホスト上に存在するすべてのサーバーのサーバー バインド ハンドルを指定します。 アプリケーションは、他のリモート プロシージャ 呼び出しを行うために使用しているのと同じバインド ハンドルを指定できることに注意してください。
IfId
エンドポイント マップから削除するインターフェイス識別子。
Binding
削除するバインド ハンドル。
ObjectUuid
削除する省略可能なオブジェクト UUID。 値 NULL は、削除するオブジェクト UUID がないことを示します。
戻り値
リターン コード | 説明 |
---|---|
|
呼び出しは成功しました。 |
|
要求された操作を実行できません。 |
注釈
RpcMgmtEpUnregister 関数は、エンドポイント マップから要素の登録を解除します。 管理プログラムは、この関数を呼び出して、使用できなくなったサーバーのアドレスを削除したり、提供されなくなったオブジェクトをサポートするサーバーのアドレスを削除したりします。
EpBinding パラメーターは、完全バインドである必要があります。 EpBinding パラメーターに関連付けられているオブジェクト UUID は、nil UUID である必要があります。 nil 以外の UUID を指定すると、状態コード EPT_S_CANT_PERFORM_OPで関数が失敗します。 ホスト情報とオブジェクト UUID 以外では、この引数のすべての情報は無視されます。
アプリケーションは RpcMgmtEpEltInqNext を呼び出して、ローカル エンドポイント マップ要素を表示します。 その後、 アプリケーションは RpcMgmtEpUnregister を使用して要素を削除できます。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | rpcdce.h (Rpc.h を含む) |
Library | Rpcrt4.lib |
[DLL] | Rpcrt4.dll |