共用方式為


RpcNsBindingSelect 函式 (rpcnsi.h)

RpcNsBindingSelect 函式會從相容的系結句柄清單中傳回系結句柄。

注意 Windows Vista 和更新版本的作業系統不支援此函式。
 

語法

RPC_STATUS RpcNsBindingSelect(
  RPC_BINDING_VECTOR *BindingVec,
  RPC_BINDING_HANDLE *Binding
);

參數

BindingVec

從中選取系結句柄之用戶端相容伺服器系結句柄向量的指標。 傳回的系結向量不再參考選取的系結句柄,這會在 Binding 參數中個別傳回。

Binding

選取之系結句柄的指標。

傳回值

意義
RPC_S_OK
呼叫成功。
RPC_S_NO_MORE_BINDINGS
沒有其他系結。
 
注意 如需有效錯誤碼的清單,請參閱 RPC 傳回值
 

備註

每次用戶端呼叫 RpcNsBindingSelect 函式時,函式作業會從向量傳回另一個系結句柄。

當所有系結句柄都從向量傳回時,函式會傳回RPC_S_NO_MORE_BINDINGS的狀態,並傳回 NULLBinding 值。

選取作業會為傳回的 Binding 參數所參考的數據配置記憶體。 當用戶端完成系結句柄時,它應該呼叫 RpcBindingFree 函式來解除分配記憶體。 每個 RpcNsBindingSelect 呼叫都需要 對 RpcBindingFree 函式的對應呼叫。

用戶端可以建立自己的選取例程,以實作應用程式特定的選取準則。 在此情況下, RpcStringBindingParse 可讓您存取系結的欄位。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 rpcnsi.h (包含 Rpc.h)
程式庫 Rpcns4.lib
Dll Rpcns4.dll

另請參閱

RpcBindingFree

RpcNsBindingLookupNext

RpcStringBindingParse

select