Función RpcNsBindingSelect (rpcnsi.h)
La función RpcNsBindingSelect devuelve un identificador de enlace de una lista de identificadores de enlace compatibles.
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 |
|---|---|
|
La llamada se realizó correctamente. |
|
No más enlaces. |
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 |