rpcServerInqBindings 函式 (rpcdce.h)

發行項
03/01/2024

RpcServerInqBindings 函式會傳回可接收遠端過程調用的系結句柄。

語法

RPC_STATUS RpcServerInqBindings(
  RPC_BINDING_VECTOR **BindingVector
);

參數

BindingVector

傳回伺服器系結句柄向量指標的指標。

傳回值

值	意義
RPC_S_OK	呼叫成功。
RPC_S_NO_BINDINGS	沒有系結。

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

備註

伺服器應用程式會呼叫 RpcServerInqBindings 以取得伺服器系結句柄的向量。當伺服器應用程式呼叫下列函式來註冊通訊協定序列時，RPC 運行時間連結庫會建立系結句柄：

傳回的系結向量可以包含具有動態端點的系結句柄或具有已知端點的系結句柄，視伺服器應用程式呼叫的上述哪一個函式而定。

伺服器會使用系結句柄向量匯出至名稱服務、向本機端點對應資料庫註冊，或用於轉換成字串系結。如果沒有系結句柄， (沒有) 已註冊的通訊協定序列，此例程會傳回RPC_S_NO_BINDINGS狀態代碼和 BindingVector 參數值為 NULL。伺服器負責呼叫 RpcBindingVectorFree 函式以釋放向量所使用的記憶體。

規格需求

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