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。

傳回值

傳回碼	Description
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)
程式庫	Rpcrt4.lib
Dll	Rpcrt4.dll

另請參閱

RpcEpRegister

RpcEpUnregister

RpcMgmtEpEltInqNext