Função RpcNsBindingSelect (rpcnsi.h)

  • Artigo

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

Nota Essa função não tem suporte no Windows Vista e em sistemas operacionais posteriores.
 

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

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_NO_MORE_BINDINGS
 Não há mais associações.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

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

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rpcnsi.h (inclua Rpc.h)
Biblioteca Rpcns4.lib
DLL Rpcns4.dll

Confira também

RpcBindingFree

RpcNsBindingLookupNext

RpcStringBindingParse

select