Метод 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