RpcServerUnregisterIfEx 函式 (rpcdce.h)
RpcServerUnregisterIfEx 函式會從 RPC 運行時間連結庫登錄中移除介面。 此函式會擴充 RpcServerUnregisterIf 函式的功能。
語法
RPC_STATUS RpcServerUnregisterIfEx(
[in] RPC_IF_HANDLE IfSpec,
[in] UUID *MgrTypeUuid,
[in] int RundownContextHandles
);
參數
[in] IfSpec
要從登錄中移除的介面。
指定 Null 值,以移除先前向 MgrTypeUuid 參數中指定的類型 UUID 值註冊的所有介面。
[in] MgrTypeUuid
要從登錄中移除之管理員進入點向量類型 UUID 的指標, (EPV) 。 MgrTypeUuid 的值應該與 RpcServerRegisterIf 函式、RpcServerRegisterIf2 函數或 RpcServerRegisterIfEx 函數的呼叫中所提供的值相同。
指定 Null 值,以從登錄中移除所有先前註冊類型 UUID 的 IfSpec 參數中指定的介面。
指定 nil UUID,從登錄中移除 MIDL 產生的預設管理員 EPV。 在此情況下,所有向非 nil 類型 UUID 註冊的經理 EPV 都會保持註冊狀態。
[in] RundownContextHandles
指定是否針對使用中內容句柄呼叫取消。 如果不是零,在介面上的所有呼叫都完成之後,就會呼叫下一次。 如果設定為零,RPC 運行時間會假設伺服器已經終結其內容句柄的一部分,而且不會呼叫取消例程。
傳回值
傳回 RPC 狀態。 除非提供無效的值,否則 RpcServerUnregisterIfEx 不會失敗。
備註
RpcServerUnregisterIfEx 函式會等候指定介面上的所有呼叫完成,再取消註冊內容句柄。
RpcServerUnregisterIfEx 函式提供 RpcServerUnregisterIf 函式中提供的所有功能。 此外, RpcServerUnregisterIfEx 函式會取消註冊指定介面所註冊的所有內容句柄。 介面必須使用 strict_context_handle 屬性,否則結果為未定義。
RpcServerUnregisterIfEx 是唯一可在進程關機外部使用中內容句柄來安全卸除 DLL 的函式。 它僅適用於 Windows XP 和更新版本的 Windows。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | rpcdce.h (包含 Rpc.h) |
程式庫 | Rpcrt4.lib |
Dll | Rpcrt4.dll |