Share via


註冊端點

在伺服器主機電腦的端點對應中註冊伺服器程式,可讓用戶端程式判斷哪些端點 (通常是 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 檔案產生的 MIDL 編譯器在標頭檔中找到它。 請參閱 開發介面。 接下來, RpcEpRegister 需要您的應用程式傳遞一組儲存在系結向量的系結控制碼。

除了註冊介面名稱之外,您的伺服器應用程式也可以在端點對應中註冊物件 UUID。 在此範例中,沒有要註冊的物件 UUID,因此 RpcEpRegister 的第三個參數會設定為 Null

最後一個參數是批註字串。 雖然 RPC 執行時間程式庫未使用此字串,但建議設定字串,因為它可改善系統的管理性。 系統管理員可以使用字串來偵測哪些應用程式使用哪些埠,然後可用來判斷防火牆所要管理的埠。