CoInvalidateRemoteMachineBindings-Funktion (combaseapi.h)

  • Artikel

Weist den Dienststeuerungs-Manager an, alle zwischengespeicherten RPC-Bindungshandles für den angegebenen Computer zu leeren.

Nur Administratoren können diese Funktion aufrufen.

Syntax

HRESULT CoInvalidateRemoteMachineBindings(
  [in] LPOLESTR pszMachineName
);

Parameter

[in] pszMachineName

Der Computername, für den Bindungshandles geleert werden sollen, oder eine leere Zeichenfolge, um anzugeben, dass alle Handles im Cache geleert werden sollen.

Rückgabewert

Diese Funktion kann die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Gibt die erfolgreiche Ausführung an.
CO_S_MACHINENAMENOTFOUND
 Gibt an, dass der angegebene Computername nicht gefunden wurde oder der Bindungshandlecache leer war, was angibt, dass anstelle eines bestimmten Computernamens eine leere Zeichenfolge übergeben wurde.
E_ACCESSDENIED
 Gibt an, dass der Aufrufer kein Administrator für diesen Computer war.
E_INVALIDARG
 Gibt an, dass ein NULL-Wert für pszMachineName übergeben wurde.

Hinweise

Der OLE Service Control Manager wird von COM verwendet, um Komponentenaktivierungsanforderungen an andere Computer zu senden. Dazu verwaltet der OLE-Dienststeuerungs-Manager einen Cache mit RPC-Bindungshandles, um Aktivierungsanforderungen nach Computernamen zu senden. Unter normalen Umständen funktioniert dies gut, aber in einigen Szenarien, z. B. Webfarmen und Lastenausgleichssituationen, kann die Möglichkeit erforderlich sein, diesen Cache mit bestimmten Handles zu bereinigen, um die erneute Bindung an einen anderen physischen Server mit demselben Namen zu erleichtern. Zu diesem Zweck wird CoInvalidateRemoteMachineBindings verwendet.

Der OLE-Dienststeuerungs-Manager löscht nicht verwendete Bindungshandles im Laufe der Zeit. Dazu ist es nicht erforderlich, CoInvalidateRemoteMachineBindings aufzurufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile combaseapi.h (include Objbase.h)
Bibliothek Ole32.lib
DLL Ole32.dll