Прочитать на английском

Поделиться через

Функция CoInvalidateRemoteMachineBindings (combaseapi.h)

  • 24.02.2024

Указывает диспетчеру управления службами очистить все кэшированные дескрипторы привязки RPC для указанного компьютера.

Только администраторы могут вызывать эту функцию.

Синтаксис

HRESULT CoInvalidateRemoteMachineBindings(
  [in] LPOLESTR pszMachineName
);

Параметры

[in] pszMachineName

Имя компьютера, для которого должны быть сброшены дескрипторы привязки, или пустая строка, означающая, что все дескрипторы в кэше должны быть сброшены.

Возвращаемое значение

Эта функция может возвращать следующие значения.

Код возврата Описание
S_OK
 Указывает на успешное завершение.
CO_S_MACHINENAMENOTFOUND
 Указывает, что указанное имя компьютера не найдено или кэш дескриптора привязки был пуст, что означает, что была передана пустая строка вместо определенного имени компьютера.
E_ACCESSDENIED
 Указывает, что вызывающий объект не был администратором этого компьютера.
E_INVALIDARG
 Указывает, что для pszMachineName было передано значение NULL.

Комментарии

Диспетчер управления службами OLE используется COM для отправки запросов на активацию компонентов на другие компьютеры. Для этого диспетчер управления службами OLE поддерживает кэш дескрипторов привязки RPC для отправки запросов активации на компьютер с ключом по имени компьютера. В обычных условиях это работает хорошо, но в некоторых сценариях, таких как веб-фермы и ситуации балансировки нагрузки, может потребоваться возможность очистки этого кэша определенных дескрипторов, чтобы упростить повторную привязку к другому физическому серверу с тем же именем. Для этой цели используется CoInvalidateRemoteMachineBindings.

Диспетчер управления службами OLE будет сбрасывать неиспользуемые дескрипторы привязки с течением времени. Для этого не нужно вызывать CoInvalidateRemoteMachineBindings .

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header combaseapi.h (включая Objbase.h)
Библиотека Ole32.lib
DLL Ole32.dll