Função RpcNsBindingSelect (rpcnsi.h)

A função RpcNsBindingSelect retorna um identificador de associação de uma lista de identificadores de associação compatíveis.

Sintaxe

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

Parâmetros

BindingVec

Ponteiro para o vetor de identificadores de associação de servidor compatíveis com o cliente dos quais um identificador de associação é selecionado. O vetor de associação retornado não faz mais referência ao identificador de associação selecionado, que é retornado separadamente no parâmetro Binding .

Binding

Ponteiro para um identificador de associação selecionado.

Valor retornado

Comentários

Sempre que o cliente chama a função RpcNsBindingSelect , a operação de função retorna outro identificador de associação do vetor.

Quando todos os identificadores de associação forem retornados do vetor, a função retornará uma status de RPC_S_NO_MORE_BINDINGS e retornará um valor binding de NULL.

A operação de seleção aloca armazenamento para os dados referenciados pelo parâmetro Binding retornado. Quando um cliente termina com o identificador de associação, ele deve chamar a função RpcBindingFree para desalocar o armazenamento. Cada chamada para RpcNsBindingSelect requer uma chamada correspondente para a função RpcBindingFree .

Os clientes podem criar suas próprias rotinas selecionadas implementando critérios de seleção específicos do aplicativo. Nesse caso, RpcStringBindingParse fornece acesso aos campos de uma associação.

Requisitos

Confira também

RpcBindingFree

RpcNsBindingLookupNext

RpcStringBindingParse

select