RpcServerUnregisterIfEx 函式 (rpcdce.h)

發行項
03/01/2024

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 不會失敗。

注意如需有效錯誤碼的清單，請參閱 RPC 傳回值。

備註

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