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
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 |