__ExtendedStatus クラス

  • [アーティクル]

__ExtendedStatus システム クラスは、詳細な状態とエラー情報を報告するために使用されます。

次の構文は、マネージド オブジェクト フォーマット (MOF) コードを簡素化しており、継承されたすべてのプロパティを含んでいます。 プロパティは、MOF 順ではなくアルファベット順で一覧表示されています。

構文

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

メンバー

__ExtendedStatus クラスには、次の種類のメンバーがあります。

プロパティ

__ExtendedStatus クラスには、次のプロパティがあります。

説明

データ型: string

アクセスの種類: 読み取り専用

エラーまたは操作状態を記述するユーザー定義文字列。

操作

データ型: string

アクセスの種類: 読み取り専用

エラーまたは異常時に実行される操作。 通常、Windows Management Instrumentation (WMI) では、このプロパティは、IWbemServices::CreateInstanceEnum のような WMI メソッドの COM API の名前に設定されます。

ParameterInfo

データ型: string

アクセスの種類: 読み取り専用

エラーまたは状態の変更に関連するパラメータ。 たとえば、存在しないクラスをアプリケーションで取得しようとすると、このプロパティは問題のあるクラス名に設定されます。

ProviderName

データ型: string

アクセスの種類: 読み取り専用

エラーまたは状態の変更を引き起こしているか報告しているプロバイダーを識別します。 プロバイダーが関係しない場合、この文字列は "Windows Management" に設定されます。

StatusCode

データ型: uint32

アクセスの種類: 読み取り専用

操作に関するエラーまたは情報コードが含まれます。 これには、プロバイダーによって定義される任意の値を指定できますが、値 0 (ゼロ) は通常、成功を示すために予約されています。 このプロパティは、__NotifyStatus から継承されます。

解説

__ExtendedStatus クラスは、__NotifyStatus クラスから派生しています。

__ExtendedStatus クラスを使用して、単純な結果コードよりも複雑な情報を報告します。 プロバイダーでは、エラーを記述するためにより多くのプロパティが必要な場合、__ExtendedStatus から独自のクラスを派生させることができます。

__NotifyStatus 親クラスから継承された StatusCode プロパティは、エラーまたは状態値を表す符号なし整数です。 このクラスのインスタンスが動的プロバイダーによってメソッドから返されると、StatusCode および Description プロパティはプロバイダーによって設定され、その他のプロパティは WMI によって設定されます。

例

TechNet ギャラリーにある FND: WMI を使用して Configuration Manager の非同期エラーを処理する方法に関する 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 システム クラス