Метод INetDiagHelper::GetAttributes (ndhelper.h)

Статья
08/25/2023

Метод GetAttributes извлекает дополнительные сведения о проблеме, которую диагностировало расширение вспомогательного класса.

Синтаксис

HRESULT GetAttributes(
  [out] ULONG            *pcelt,
  [out] HELPER_ATTRIBUTE **pprgAttributes
);

Параметры

[out] pcelt

Указатель на количество элементов в массиве HELPER_ATTRIBUTE .

[out] pprgAttributes

Указатель на массив HELPER_ATTRIBUTE структур.

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

Код возврата	Описание
S_OK	Операция успешно выполнена.
E_OUTOFMEMORY	Для выполнения этой операции недостаточно памяти.
E_INVALIDARG	Один или несколько параметров указаны неправильно.
E_NOTIMPL	Этот необязательный метод не реализован.
E_ACCESSDENIED	Вызывающий объект не имеет достаточных привилегий для выполнения операции диагностики или восстановления.
E_ABORT	Операция диагностики или восстановления отменена.

Расширения вспомогательного класса могут возвращать HRESULTS, относящиеся к сбоям, возникшим в функции.

В процессе диагностики и восстановления вспомогательный класс может при необходимости возвращать атрибуты в NDF, улучшающие обработку диагностики. Ниже приведены стандартные атрибуты, которые можно вернуть в NDF.

Термин	Описание
werperameter (Тип: AT_UINT32)	При сбое диагностики необязательный атрибут для дополнительного вспомогательного класса отчеты об ошибках Windows параметр сегментирования (WER).
werfile (тип: AT_STRING)	Необязательный атрибут для добавления файлов вспомогательного класса в отчеты отчеты об ошибках Windows (WER).
rootcauseid (Тип: AT_GUID)	Вспомогательные классы часто могут диагностировать несколько проблем одновременно. Анализ обнаруженной проблемы можно улучшить в NDF, если расширение возвращает атрибут HelperAttribute типа AT_GUID с параметром pszName, равным rootcauseid, а в поле Guid — guid, определяющий конкретную возникшую проблему. Эти идентификаторы GUID настраиваются вспомогательным расширением.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	ndhelper.h

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

INetDiagHelper

Share via