__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 네임스페이스

추가 정보

__NotifyStatus

WMI 시스템 클래스