rpcServerRegisterIf 函式 (rpcdce.h)

RpcServerRegisterIf 函式會向 RPC 運行時間連結庫註冊介面。

語法

RPC_STATUS RpcServerRegisterIf(
  RPC_IF_HANDLE IfSpec,
  UUID          *MgrTypeUuid,
  RPC_MGR_EPV   *MgrEpv
);

IfSpec

MIDL 產生的結構，表示要註冊的介面。

MgrTypeUuid

要與 MgrEpv 參數產生關聯的類型 UUID 指標。指定 null 參數值 (或 nil UUID) 會向 nil 類型 UUID 註冊 IfSpec 。

MgrEpv

管理員例程的進入點向量 (EPV) 。若要使用 MIDL 產生的預設 EPV，請指定 Null 值。如需詳細資訊，請參閱 RPC_MGR_EPV。

成功時傳回RPC_S_OK。

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

伺服器可以使用 RPC 執行時間連結庫註冊不限數目的介面。註冊可讓用戶端使用伺服器的系結句柄來使用介面。若要註冊介面，伺服器應用程式程式代碼會呼叫 RpcServerRegisterIf。針對伺服器提供的每個介面實作，它必須註冊個別的管理員 EPV。

呼叫 RpcServerRegisterIf 時，伺服器會提供下列資訊：

介面規格
介面規格是 MIDL 編譯程式所產生的數據結構。伺服器會使用 IfSpec 參數來指定介面。
管理員類型 UUID 和管理員 EPV
管理員類型 UUID 和管理員 EPV 會決定當伺服器收到來自客戶端的遠端過程調用要求時，所執行的管理員例程。

伺服器會使用 MgrTypeUuid 和 MgrEpv 參數來指定管理員類型 UUID 和 EPV。請注意，指定非 nil 管理員類型 UUID 時，伺服器也必須呼叫 RpcObjectSetType 函式來註冊此非 nil 類型的物件。

如果您的伺服器應用程式需要註冊自動接聽介面或使用回呼函式進行驗證，請使用 RpcServerRegisterIfEx。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	rpcdce.h (包含 Rpc.h)
程式庫	Rpcrt4.lib
Dll	Rpcrt4.dll