CoInvalidateRemoteMachineBindings function (combaseapi.h)

Tells the service control manager to flush any cached RPC binding handles for the specified computer.

Only administrators may call this function.

Syntax

HRESULT CoInvalidateRemoteMachineBindings(
  [in] LPOLESTR pszMachineName
);

Parameters

[in] pszMachineName

The computer name for which binding handles should be flushed, or an empty string to signify that all handles in the cache should be flushed.

Return value

This function can return the following values.

Return code Description
S_OK
Indicates success.
CO_S_MACHINENAMENOTFOUND
Indicates that the specified computer name was not found or that the binding handle cache was empty, indicating that an empty string was passed instead of a specific computer name.
E_ACCESSDENIED
Indicates the caller was not an administrator for this computer.
E_INVALIDARG
Indicates that a NULL value was passed for pszMachineName.

Remarks

The OLE Service Control Manager is used by COM to send component activation requests to other machines. To do this, the OLE Service Control Manager maintains a cache of RPC binding handles to send activation requests to computer, keyed by computer name. Under normal circumstances, this works well, but in some scenarios, such as Web farms and load-balancing situations, the ability to purge this cache of specific handles might be needed in order to facilitate rebinding to a different physical server by the same name. CoInvalidateRemoteMachineBindings is used for this purpose.

The OLE Service Control Manager will flush unused binding handles over time. It is not necessary to call CoInvalidateRemoteMachineBindings to do this.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header combaseapi.h (include Objbase.h)
Library Ole32.lib
DLL Ole32.dll