Función RpcNsBindingSelect (rpcnsi.h)

La función RpcNsBindingSelect devuelve un identificador de enlace de una lista de identificadores de enlace compatibles.

Nota Esta función no se admite en Windows Vista ni en sistemas operativos posteriores.

 

Sintaxis

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

Parámetros

BindingVec

Puntero al vector de identificadores de enlace de servidor compatibles con el cliente desde el que se selecciona un identificador de enlace. El vector de enlace devuelto ya no hace referencia al identificador de enlace seleccionado, que se devuelve por separado en el parámetro Binding .

Binding

Puntero a un identificador de enlace seleccionado.

Valor devuelto

Valor	Significado
RPC_S_OK	La llamada se realizó correctamente.
RPC_S_NO_MORE_BINDINGS	No más enlaces.

 

Nota Para obtener una lista de códigos de error válidos, consulte Rpc Return Values.

 

Comentarios

Cada vez que el cliente llama a la función RpcNsBindingSelect , la operación de función devuelve otro identificador de enlace del vector.

Cuando se han devuelto todos los identificadores de enlace del vector, la función devuelve un estado de RPC_S_NO_MORE_BINDINGS y devuelve un valor Binding de NULL.

La operación de selección asigna almacenamiento para los datos a los que hace referencia el parámetro Binding devuelto. Cuando un cliente finaliza con el identificador de enlace, debe llamar a la función RpcBindingFree para desasignar el almacenamiento. Cada llamada a RpcNsBindingSelect requiere una llamada correspondiente a la función RpcBindingFree .

Los clientes pueden crear sus propias rutinas de selección que implementan criterios de selección específicos de la aplicación. En este caso, RpcStringBindingParse proporciona acceso a los campos de un enlace.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	rpcnsi.h (incluir Rpc.h)
Library	Rpcns4.lib
Archivo DLL	Rpcns4.dll

Consulte también

RpcBindingFree

RpcNsBindingLookupNext

RpcStringBindingParse

select