Funzione RpcNsBindingSelect (rpcnsi.h)

  • Articolo

La funzione RpcNsBindingSelect restituisce un handle di associazione da un elenco di handle di associazione compatibili.

Nota Questa funzione non è supportata in Windows Vista e nei sistemi operativi successivi.
 

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
RPC_S_OK
 La chiamata ha avuto esito positivo.
RPC_S_NO_MORE_BINDINGS
 Nessuna associazione.
 
Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.
 

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

Vedi anche

RpcBindingFree

RpcNsBindingLookupNext

RpcStringBindingParse

select