Funzione CoInvalidateRemoteMachineBindings (combaseapi.h)

  • Articolo

Indica al gestore del controllo del servizio di scaricare eventuali handle di associazione RPC memorizzati nella cache per il computer specificato.

Solo gli amministratori possono chiamare questa funzione.

Sintassi

HRESULT CoInvalidateRemoteMachineBindings(
  [in] LPOLESTR pszMachineName
);

Parametri

[in] pszMachineName

Nome del computer per il quale gli handle di associazione devono essere scaricati o una stringa vuota per indicare che tutti gli handle nella cache devono essere scaricati.

Valore restituito

Questa funzione può restituire i valori seguenti.

Codice restituito Descrizione
S_OK
 Indica l'esito positivo dell'operazione.
CO_S_MACHINENAMENOTFOUND
 Indica che il nome del computer specificato non è stato trovato o che la cache dell'handle di associazione è vuota, a indicare che è stata passata una stringa vuota anziché un nome computer specifico.
E_ACCESSDENIED
 Indica che il chiamante non era un amministratore per questo computer.
E_INVALIDARG
 Indica che è stato passato un valore NULL per pszMachineName.

Commenti

Ole Service Control Manager viene usato da COM per inviare richieste di attivazione dei componenti ad altri computer. A tale scopo, OLE Service Control Manager gestisce una cache di handle di associazione RPC per inviare richieste di attivazione al computer, con chiave in base al nome del computer. In circostanze normali, questa operazione funziona correttamente, ma in alcuni scenari, ad esempio web farm e situazioni di bilanciamento del carico, potrebbe essere necessaria la possibilità di eliminare questa cache di handle specifici per facilitare il riassociamento a un server fisico diverso con lo stesso nome. CoInvalidateRemoteMachineBindings viene usato a questo scopo.

Gestione controllo servizi OLE scarica gli handle di associazione inutilizzati nel tempo. Non è necessario chiamare CoInvalidateRemoteMachineBindings per eseguire questa operazione.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione combaseapi.h (include Objbase.h)
Libreria Ole32.lib
DLL Ole32.dll