註冊端點

在伺服器主計算機的端點對應中註冊伺服器程式,可讓用戶端程式判斷伺服器程式正在接聽的端點(通常是 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 執行時間連結庫不會使用此字串,但建議設定字串,因為它可改善系統的管理性。 系統管理員可以使用字串來偵測哪些應用程式所使用的埠,然後可用來判斷防火牆要管理的埠。