在伺服器主計算機的端點對應中註冊伺服器程式,可讓用戶端程式判斷伺服器程式正在接聽的端點(通常是 TCP/IP 埠或命名管道)。 若要在伺服器主機系統的端點對應中註冊本身,伺服器程式會呼叫 RpcEpRegister 函式,如下列代碼段所示:
// This example assumes that MyInterface_v1_0_s_ifspec is a valid data
// structure that represents the interface being registered. The
// variable is a valid pointer to a binding vector.
RPC_STATUS status;
status = RpcEpRegister(
MyInterface_v1_0_s_ifspec,
rpcBindingVector,
NULL,
NULL);
RpcEpRegister的第一個參數是表示介面的結構。 您可以在此分散式應用程式的 MIDL 檔案所產生的 MIDL 編譯程式頭檔中找到它。 請參閱 開發介面。 接下來,RpcEpRegister 需要您的應用程式傳遞一組儲存在系結向量中的系結句柄。
除了註冊介面名稱之外,您的伺服器應用程式也可以於端點對映表中註冊物件 UUID。 在此例中,沒有要註冊的物件 UUID,因此 RpcEpRegister 的第三個參數會設為 NULL。
最後一個參數是批注字串。 雖然 RPC 執行時間連結庫不會使用此字串,但建議設定字串,因為它可改善系統的管理性。 系統管理員可以使用字串來偵測哪些應用程式所使用的埠,然後可用來判斷防火牆要管理的埠。