Funzione RpcNsBindingSelect (rpcnsi.h)
La funzione RpcNsBindingSelect restituisce un handle di associazione da un elenco di handle di associazione compatibili.
Sintassi
RPC_STATUS RpcNsBindingSelect(
RPC_BINDING_VECTOR *BindingVec,
RPC_BINDING_HANDLE *Binding
);
Parametri
BindingVec
Puntatore al vettore di handle di associazione server compatibili con il client da cui è selezionato un handle di associazione. Il vettore di associazione restituito non fa più riferimento all'handle di associazione selezionato, che viene restituito separatamente nel parametro Binding .
Binding
Puntatore a un handle di associazione selezionato.
Valore restituito
| Valore | Significato |
|---|---|
|
La chiamata ha avuto esito positivo. |
|
Nessuna associazione. |
Commenti
Ogni volta che il client chiama la funzione RpcNsBindingSelect , l'operazione della funzione restituisce un altro handle di associazione dal vettore.
Quando tutti gli handle di associazione sono stati restituiti dal vettore, la funzione restituisce uno stato di RPC_S_NO_MORE_BINDINGS e restituisce un valoreBinding null.
L'operazione select alloca l'archiviazione per i dati a cui fa riferimento il parametro Binding restituito. Quando un client termina con l'handle di associazione, deve chiamare la funzione RpcBindingFree per deallocare l'archiviazione. Ogni chiamata a RpcNsBindingSelect richiede una chiamata corrispondente alla funzione RpcBindingFree .
I client possono creare routine di selezione personalizzate che implementano criteri di selezione specifici dell'applicazione. In questo caso , RpcStringBindingParse fornisce l'accesso ai campi di un'associazione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | rpcnsi.h (include Rpc.h) |
| Libreria | Rpcns4.lib |
| DLL | Rpcns4.dll |