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 類型的物件。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | rpcdce.h (包含 Rpc.h) |
程式庫 | Rpcrt4.lib |
Dll | Rpcrt4.dll |