Compartir a través de

Función CoInvalidateRemoteMachineBindings (combaseapi.h)

  • Artículo

Indica al administrador de control de servicio que vacíe los identificadores de enlace RPC almacenados en caché para el equipo especificado.

Solo los administradores pueden llamar a esta función.

Sintaxis

HRESULT CoInvalidateRemoteMachineBindings(
  [in] LPOLESTR pszMachineName
);

Parámetros

[in] pszMachineName

Nombre de equipo para el que se deben vaciar los identificadores de enlace o una cadena vacía para indicar que se deben vaciar todos los identificadores de la memoria caché.

Valor devuelto

Esta función puede devolver los siguientes valores.

Código devuelto Descripción
S_OK
 Indica que se completó correctamente.
CO_S_MACHINENAMENOTFOUND
 Indica que no se encontró el nombre de equipo especificado o que la memoria caché del identificador de enlace estaba vacía, lo que indica que se pasó una cadena vacía en lugar de un nombre de equipo específico.
E_ACCESSDENIED
 Indica que el autor de la llamada no era administrador de este equipo.
E_INVALIDARG
 Indica que se pasó un valor NULL para pszMachineName.

Comentarios

COM usa OLE Service Control Manager para enviar solicitudes de activación de componentes a otras máquinas. Para ello, OLE Service Control Manager mantiene una caché de identificadores de enlace RPC para enviar solicitudes de activación al equipo, con clave por nombre de equipo. En circunstancias normales, esto funciona bien, pero en algunos escenarios, como granjas de servidores web y situaciones de equilibrio de carga, la capacidad de purgar esta caché de identificadores específicos podría ser necesaria para facilitar la reenlazamiento a un servidor físico diferente con el mismo nombre. CoInvalidateRemoteMachineBindings se usa para este propósito.

Ole Service Control Manager vaciará los identificadores de enlace sin usar con el tiempo. No es necesario llamar a CoInvalidateRemoteMachineBindings para hacerlo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado combaseapi.h (incluya Objbase.h)
Library Ole32.lib
Archivo DLL Ole32.dll