Clase __ExtendedStatus

La clase del sistema __ExtendedStatus se usa para notificar información detallada de estado y error.

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades se indican en orden alfabético, no en orden de MOF.

Sintaxis

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

Miembros

La clase __ExtendedStatus tiene estos tipos de miembros:

• Propiedades

Propiedades

La clase __ExtendedStatus tiene estas propiedades.

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Cualquier cadena definida por el usuario que describa un error o estado operativo.

operación

Tipo de datos: cadena

Tipo de acceso: solo lectura

Operación que tiene lugar en el momento de un error o anomalía. Normalmente, Instrumental de administración de Windows (WMI) establece esta propiedad en el nombre de una API COM para el método WMI, como este: IWbemServices::CreateInstanceEnum.

ParameterInfo

Tipo de datos: cadena

Tipo de acceso: solo lectura

Parámetros implicados en un cambio de estado o error. Por ejemplo, si una aplicación intenta recuperar una clase que no existe, esta propiedad se establece en el nombre de clase infractor.

ProviderName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Identifica el proveedor que provoca o notifica un cambio de estado o error. Si no hay un proveedor implicado, esta cadena se establece en "Administración de Windows".

StatusCode

Tipo de datos: uint32

Tipo de acceso: solo lectura

Contiene un error o código de información para una operación. Puede ser cualquier valor definido por el proveedor, pero el valor 0 (cero) normalmente se reserva para indicar que se ha realizado correctamente. Esta propiedad se hereda de __NotifyStatus.

Comentarios

La clase __ExtendedStatus se deriva de la clase __NotifyStatus.

Use la clase __ExtendedStatus para notificar información más compleja que un código de resultado simple. Los proveedores pueden derivar sus propias clases de __ExtendedStatus si requieren más propiedades para describir los errores.

La propiedad StatusCode, que se hereda de la clase primaria __NotifyStatus, es un entero sin signo que representa el valor de error o estado. Cuando un proveedor dinámico devuelve instancias de esta clase desde un método, el proveedor establece las propiedades StatusCode y Description, mientras que WMI establece las demás propiedades.

Ejemplos

En el ejemplo de código siguiente, que se toma del ejemplo de código FND:How to Handle Configuration Manager Asynchronous Errors by Using WMI de VBScript en la Galería de TechNet, se describe el uso de __ExtendedStatus para recuperar información de error.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Todos los espacios de nombres WMI

Consulte también

__NotifyStatus

Clases del sistema WMI