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的狀態，並傳回 NULL 的 Binding 值。

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

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