класс __ExtendedStatus

Статья
11/10/2023

Системный класс __ExtendedStatus используется для создания подробных сведений о состоянии и ошибках.

Следующий синтаксис упрощен из кода управляемого формата объектов (MOF) и включает все унаследованные свойства. Свойства перечислены в алфавитном порядке, а не в порядке MOF.

Синтаксис

class __ExtendedStatus : __NotifyStatus
{
  string Description;
  string Operation;
  string ParameterInfo;
  string ProviderName;
  uint32 StatusCode;
};

Участники

Класс __ExtendedStatus имеет следующие типы элементов:

Свойства

Свойства

Класс __ExtendedStatus имеет эти свойства.

Description

Тип данных: строка
Тип доступа: только для чтения

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

Операция

Тип данных: строка
Тип доступа: только для чтения

Операция, которая происходит во время сбоя или аномалии. Как правило, инструментарий управления Windows (WMI) задает этому свойству имя МЕТОДА COM API для WMI, например следующего: IWbemServices::CreateInstanceEnum.

ParameterInfo

Тип данных: строка
Тип доступа: только для чтения

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

ProviderName

Тип данных: строка
Тип доступа: только для чтения

Определяет поставщика, который вызывает или сообщает об ошибке или изменении состояния. Если поставщик не участвует, эта строка имеет значение "Управление Windows".

StatusCode

Тип данных: uint32
Тип доступа: только для чтения

Содержит код ошибки или сведений для операции. Это может быть любое значение, определенное поставщиком, но значение 0 (ноль) обычно зарезервировано для указания успешности. Это свойство наследуется от __NotifyStatus.

Замечания

Класс __ExtendedStatus является производным от класса __NotifyStatus.

Используйте класс __ExtendedStatus для отправки сведений, которые являются более сложными, чем простой код результата. Поставщики могут наследовать собственные классы от __ExtendedStatus , если требуются дополнительные свойства для описания ошибок.

Свойство StatusCode , унаследованное от родительского класса __NotifyStatus , представляет собой целое число без знака, представляющее значение ошибки или состояния. Если экземпляры этого класса возвращаются из метода динамическим поставщиком, свойства StatusCode и Description задаются поставщиком, а другие свойства задаются WMI.

Примеры

В следующем примере кода VBScript описывается использование __ExtendedStatus для получения сведений об ошибке.

Sub sink_OnCompleted(HResult, oErr, oCtx) 
    WScript.Echo "All collections returned" 
  
    if HResult <> 0 Then  
    ' Determine the type of error. 
        If oErr.Path_.Class = "__ExtendedStatus" Then 
            WScript.Echo "WMI Error: "& oErr.Description             
        ElseIf ExtendedStatus.Path_.Class = "SMS_ExtendedStatus" Then 
            WScript.Echo "Provider Error: "& oErr.Description 
            WScript.Echo "Code: " & oErr.ErrorCode 
        End If 
    End If     
    bdone = true 
End sub

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Все пространства имен WMI

См. также

__NotifyStatus
Системные классы WMI