__ExtendedStatus class
__ExtendedStatus 시스템 클래스는 자세한 상태 및 오류 정보를 보고하는 데 사용됩니다.
MOF(Managed Object Format) 코드에서 간결하게 표기된 다음 구문은 상속된 속성을 모두 포함합니다. 속성은 MOF 순서가 아닌 알파벳순으로 나열됩니다.
구문
class __ExtendedStatus : __NotifyStatus
{
string Description;
string Operation;
string ParameterInfo;
string ProviderName;
uint32 StatusCode;
};
멤버
__ExtendedStatus 클래스에는 다음과 같은 유형의 멤버가 있습니다.
속성
__ExtendedStatus 클래스에는 해당 속성이 있습니다.
-
설명
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
오류 또는 작동 상태를 설명하는 모든 사용자 정의 문자열입니다.
-
-
연산
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
오류 또는 변칙 시 발생하는 작업입니다. 일반적으로 Windows Management Instrumentation(WMI)는 이 속성을 IWbemServices::CreateInstanceEnum과 같은 WMI 메서드용 COM API의 이름으로 설정합니다.
-
-
ParameterInfo
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
오류 또는 상태 변경과 관련된 매개 변수입니다. 예를 들어 애플리케이션이 존재하지 않는 클래스를 검색하려고 하면 이 속성이 잘못된 클래스 이름으로 설정됩니다.
-
-
ProviderName
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
오류 또는 상태 변경을 발생하거나 보고하는 공급자를 식별합니다. 공급자가 포함되지 않은 경우 이 문자열은 “Windows 관리”로 설정됩니다.
-
-
StatusCode
-
-
데이터 형식: uint32
-
액세스 형식: 읽기 전용
작업에 대한 오류 또는 정보 코드를 포함합니다. 공급자가 정의한 값일 수 있지만 값 0은 일반적으로 성공을 나타내기 위해 예약됩니다. 이 속성은 __NotifyStatus에서 상속됩니다.
-
설명
__ExtendedStatus 클래스는 __NotifyStatus 클래스에서 파생됩니다.
__ExtendedStatus 클래스를 사용하여 간단한 결과 코드보다 더 복잡한 정보를 보고합니다. 공급자는 오류를 설명하는 데 더 많은 속성이 필요한 경우 __ExtendedStatus에서 자체 클래스를 파생시킬 수 있습니다.
__NotifyStatus 상위 클래스에서 상속된 StatusCode 속성은 오류 또는 상태 값을 나타내는 부호 없는 정수입니다. 동적 공급자가 메서드에서 이 클래스의 인스턴스를 반환하는 경우 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 네임스페이스 |