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 傳回值。
備註
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 |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應