Funzione RpcBindingReset (rpcdce.h)

La funzione RpcBindingReset reimposta un handle di associazione in modo che l'host sia specificato ma il server in tale host non sia specificato.

Sintassi

RPC_STATUS RpcBindingReset(
  RPC_BINDING_HANDLE Binding
);

Parametri

Binding

Handle di associazione server da reimpostare.

Valore restituito

Commenti

Un client chiama la funzione RpcBindingReset per annullare l'associazione di un'istanza del server specifica dall'handle di associazione server specificato nel parametro Binding . La funzione RpcBindingReset dissocia un'istanza del server rimuovendo la parte endpoint dell'indirizzo del server nell'handle di associazione. L'host rimane invariato nell'handle di associazione. Il risultato è un handle di associazione server parzialmente associato.

RpcBindingReset non influisce sulle informazioni di autenticazione del parametro binding , se presenti.

Se un client è disposto a essere gestito da qualsiasi istanza del server compatibile nell'host specificato nell'handle di associazione, il client chiama la funzione RpcBindingReset prima di effettuare una chiamata di procedura remota usando l'handle di associazione. I client non devono chiamare la funzione RpcBindingReset per gli handle di associazione in cui vengono eseguite le chiamate.

Quando il client effettua la chiamata alla procedura remota successiva usando l'associazione reimpostazione (parzialmente associata), la libreria di runtime RPC del client usa un endpoint noto dalla specifica dell'interfaccia del client, se presente. In caso contrario, la libreria di runtime del client comunica automaticamente con il servizio di mapping degli endpoint nell'host remoto specificato per ottenere l'endpoint di un server compatibile dal database della mappa degli endpoint. Se si trova un server compatibile, la libreria di runtime RPC aggiorna l'associazione con un nuovo endpoint. Se non viene trovato un server compatibile, la chiamata alla procedura remota ha esito negativo. Per le chiamate che usano un protocollo di connessione (ncacn), il codice di stato EPT_S_NOT_REGISTERED viene restituito al client. Per le chiamate che usano un protocollo datagram (ncadg), il codice di stato RPC_S_COMM_FAILURE viene restituito al client.

Le applicazioni server devono registrare tutti gli handle di associazione chiamando RpcEpRegistere RpcEpRegisterNoReplace se il server vuole essere disponibile ai client che effettuano una chiamata di procedura remota su un handle di associazione di reimpostazione.

Requisiti

Vedi anche

RpcEpRegister

RpcEpRegisterNoReplace