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

Метод INapSystemHealthAgentBinding::Initialize

  • Статья

Примечание

Платформа защиты доступа к сети недоступна, начиная с Windows 10

Метод INapSystemHealthAgentBinding::Initialize инициализирует агент работоспособности системы (SHA) и привязывает SHA к службе NapAgent. Этот метод необходимо вызывать перед вызовом любого другого метода в интерфейсе INapSystemHealthAgentBinding2 .

Синтаксис

HRESULT Initialize(
  [in] SystemHealthEntityId          id,
  [in] INapSystemHealthAgentCallback *callback
);

Параметры

id [in]

Уникальный идентификатор SystemHealthEntityId , содержащий идентификатор SHA, привязанного к службе NapAgent.

callback [in]

Com-указатель на интерфейс INapSystemHealthAgentCallback , используемый NapAgent для обратного вызова агента работоспособности с уведомлением или обработкой. NapAgent хранит ссылку на объект, связанный с этим интерфейсом, пока не будет вызван метод Uninitialize .

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

Также могут быть возвращены другие коды ошибок, относящихся к COM.

Код возврата Описание
S_OK
Операция успешно завершена.
E_ACCESSDENIED
Ошибка разрешений, доступ запрещен.
E_OUTOFMEMORY
Ограничение системных ресурсов, не удалось выполнить операцию.
ERROR_ALREADY_INITIALIZED
 Если SHA инициализировался ранее, возвращается эта ошибка.
NAP_E_NOT_REGISTERED
 Если SHA не зарегистрирован ранее, возвращается эта ошибка.
RPC_E_DISCONNECTED
 NapAgent остановлен. Этот объект будет автоматически восстановлен и повторно привязается к NapAgent после перезапуска.

Комментарии

NapAgent не активирует обмен SoH в результате инициализации. Агент работоспособности системы должен вызвать NotifySoHChange , чтобы запросить обмен пакетами SoH после инициализации с napAgent.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2008 [только классические приложения]
Заголовок
NapSystemHealthAgent.h
IDL
NapSystemHealthAgent.idl
DLL
Qagent.dll

См. также раздел

INapSystemHealthAgentBinding