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

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

  • Статья

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