__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 名前空間 |