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 がないことを示します。

戻り値

リターン コード 説明
RPC_S_OK
 呼び出しは成功しました。
RPC_S_CANT_PERFORM_OP
 要求された操作を実行できません。
 
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
 

注釈

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

こちらもご覧ください

RpcEpRegister

RpcEpUnregister

RpcMgmtEpEltInqNext