Метод INapSystemHealthValidationRequest::GetSoHRequest

Примечание

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

Метод INapSystemHealthValidationRequest::GetSoHRequest позволяет проверяющие элементы управления работоспособности системы (SHV) получать и проверять сведения SoHRequest , отправленные их коллегами из агента работоспособности системы (SHA) на клиенте.

Синтаксис

HRESULT GetSoHRequest(
  [out] SoHRequest **sohRequest,
  [out] BOOL       *napSystemGenerated
);

Параметры

sohRequest [out]

Указатель на структуру SoHRequest .

napSystemGenerated [out]

Значение BOOL, которое имеет значение TRUE, если SoH был создан NapAgent от имени SHA, и FALSE в противном случае. Он в основном используется для обозначения сбоя SHA в SHV.

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

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

Код возврата	Описание
S_OK	Операция успешно завершена.
E_ACCESSDENIED	Ошибка разрешений, доступ запрещен.
E_OUTOFMEMORY	Ограничение системных ресурсов, не удалось выполнить операцию.

Комментарии

Параметр sohRequest может возвращать значение NULL , если клиент не отправил запрос SoHRequest в SHV. В этом сценарии SHV может заполнить SoHResponse кодом ошибки NAP_E_MISSING_SOH.

Если параметр napSystemGenerated имеет значение TRUE, формат SoHRequest выглядит следующим образом:

• sohAttributeTypeSystemHealthId= <id>
• sohAttributeTypeFailureCategory= failureCategoryClientComponent
• sohAttributeTypeErrorCodes = <sha-failure-error-code>

Требования

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

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

INapSystemHealthValidationRequest