rpcServerInqBindings 函式 (rpcdce.h)
RpcServerInqBindings 函式會傳回可接收遠端過程調用的系結句柄。
語法
RPC_STATUS RpcServerInqBindings(
RPC_BINDING_VECTOR **BindingVector
);
參數
BindingVector
傳回伺服器系結句柄向量指標的指標。
傳回值
值 | 意義 |
---|---|
|
呼叫成功。 |
|
沒有系結。 |
注意 如需有效錯誤碼的清單,請參閱 RPC 傳回值。
備註
伺服器應用程式會呼叫 RpcServerInqBindings 以取得伺服器系結句柄的向量。 當伺服器應用程式呼叫下列函式來註冊通訊協定序列時,RPC 運行時間連結庫會建立系結句柄:
- RpcServerUseAllProtseqs
- RpcServerUseAllProtseqsEx
- RpcServerUseAllProtseqsIf
- RpcServerUseAllProtseqsIfEx
- RpcServerUseProtseq
- RpcServerUseProtseqEx
- RpcServerUseProtseqEpEx
- RpcServerUseProtseqIf
- RpcServerUseProtseqIfEx
- RpcServerUseProtseqEp
伺服器會使用系結句柄向量匯出至名稱服務、向本機端點對應資料庫註冊,或用於轉換成字串系結。 如果沒有系結句柄, (沒有) 已註冊的通訊協定序列,此例程會傳回RPC_S_NO_BINDINGS狀態代碼和 BindingVector 參數值為 NULL。 伺服器負責呼叫 RpcBindingVectorFree 函式以釋放向量所使用的記憶體。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | rpcdce.h (包含 Rpc.h) |
程式庫 | Rpcrt4.lib |
Dll | Rpcrt4.dll |