Funzione RpcServerInqBindings (rpcdce.h)

Articolo
03/01/2024

La funzione RpcServerInqBindings restituisce gli handle di associazione su cui è possibile ricevere chiamate di routine remote.

Sintassi

RPC_STATUS RpcServerInqBindings(
  RPC_BINDING_VECTOR **BindingVector
);

Parametri

BindingVector

Restituisce un puntatore a un puntatore a un vettore di handle di associazione server.

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_NO_BINDINGS	Non sono presenti associazioni.

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

Commenti

Un'applicazione server chiama RpcServerInqBindings per ottenere un vettore di handle di associazione server. La libreria di runtime RPC crea handle di associazione quando un'applicazione server chiama le funzioni seguenti per registrare le sequenze di protocollo:

Il vettore di associazione restituito può contenere handle di associazione con endpoint dinamici o handle di associazione con endpoint noti, a seconda di quale delle funzioni precedenti l'applicazione server chiamata.

Un server usa il vettore di handle di associazione per l'esportazione nel servizio dei nomi, per la registrazione con il database di mapping dell'endpoint locale o per la conversione in associazioni di stringhe. Se non sono presenti handle di associazione (nessuna sequenza di protocollo registrata), questa routine restituisce il codice di stato RPC_S_NO_BINDINGS e un valore di parametro BindingVector null. Il server è responsabile della chiamata della funzione RpcBindingVectorFree per rilasciare la memoria usata dal vettore.

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	rpcdce.h (include Rpc.h)
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll