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
| Valore | Significato |
|---|---|
|
La chiamata ha avuto esito positivo. |
|
L'handle di associazione non è valido. |
|
Questo è stato il tipo di associazione sbagliato per l'operazione. |
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
| Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | rpcdce.h (include Rpc.h) |
| Libreria | Rpcrt4.lib |
| DLL | Rpcrt4.dll |