Funzione CoInvalidateRemoteMachineBindings (combaseapi.h)

Articolo
02/24/2024

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

Condividi tramite