SWbemServices.SubclassesOf 메서드

아티클
06/13/2023

SWbemServices 개체의 SubclassesOf 메서드는 SWbemObjectSet 개체를 반환합니다. 이 개체는 지정된 클래스의 하위 클래스 컬렉션입니다. 반환된 컬렉션의 항목은 표준 컬렉션 메서드를 사용하여 가져올 수 있습니다. 자세한 내용은 컬렉션 액세스를 참조하세요.

이 메서드는 클래스 개체에 대해서만 작동합니다.

이 메서드는 반동기 모드에서 호출됩니다. 자세한 내용은 메서드 호출을 참조하세요.

이 구문에 대한 설명은 스크립팅 API의 문서 규칙을 참조하세요.

구문

objWbemObjectSet = .SubclassesOf( _
  [ ByVal strSuperclass ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

매개 변수

strSuperclass [optional]: 부모 클래스 이름을 지정합니다. 이 클래스의 하위 클래스만 열거자에서 반환됩니다. 이 매개 변수를 비워 두고 iFlags가 wbemQueryFlagShallow인 경우 최상위 클래스(즉, 부모 클래스가 없는 클래스)만 반환됩니다. 이 매개 변수가 비어 있고 iFlags가 wbemQueryFlagDeep인 경우 네임스페이스 내의 모든 클래스가 반환됩니다.
iFlags [optional]: 호출이 열거하는 세부 정보를 결정합니다. 이 매개 변수의 기본값은 wbemFlagReturnImmediately 및 wbemQueryFlagDeep입니다. 이 매개 변수는 다음 값을 허용할 수 있습니다.
wbemQueryFlagShallow (1 (0x1)): 지정된 부모 클래스의 직계 하위 클래스만 포함하도록 열거형에 강제 적용합니다.
wbemQueryFlagDeep (0 (0x0)): 이 매개 변수의 기본값입니다. 이 값은 지정된 부모 클래스에서 파생된 모든 하위 클래스에 재귀 열거를 강제 적용합니다. 부모 클래스는 열거에서 반환되지 않습니다.
wbemFlagReturnImmediately (16 (0x10)): 호출이 즉시 반환되도록 합니다.
wbemFlagReturnWhenComplete (0 (0x0)): 호출이 완료될 때까지 이 호출이 차단되도록 합니다. 이 플래그는 동기 모드에서 메서드를 호출합니다.
wbemFlagUseAmendedQualifiers(131072(0x20000)): WMI가 기본 클래스 정의와 함께 클래스 수정 데이터를 반환하도록 합니다. 자세한 내용은 WMI 클래스 정보 지역화를 참조하세요.

objWbemNamedValueSet [optional]

일반적으로 이는 정의되지 않습니다. 그렇지 않으면 요청을 서비스하는 공급자가 사용할 수 있는 컨텍스트 정보를 나타내는 요소가 있는 SWbemNamedValueSet 개체입니다. 그러한 정보를 지원하거나 요구하는 공급자는 인식된 값 이름, 값의 데이터 형식, 허용된 값 및 의미 체계를 문서화해야 합니다.

반환 값

메서드가 성공하면 SWbemObjectSet 개체가 반환됩니다.

오류 코드

SubclassesOf 메서드가 완료되면 Err 개체에 다음 목록의 오류 코드 중 하나가 포함될 수 있습니다.

참고

0 요소가 있는 반환된 컬렉션은 오류가 아닙니다.

wbemErrAccessDenied - 2147749891(0x80041003): 현재 사용자는 호출에서 반환된 하나 이상의 클래스를 볼 수 있는 권한이 없습니다.
wbemErrFailed - 2147749889(0x80041001): 알 수 없는 오류입니다.
wbemErrInvalidClass - 2147749904(0x80041010): 지정된 클래스가 없습니다.
wbemErrInvalidParameter - 2147749896(0x80041008): 잘못된 매개 변수가 지정되었습니다.
wbemErrOutOfMemory - 2147749894(0x80041006): 메모리가 부족하여 작업을 완료할 수 없습니다.

예제

다음 PowerShell 샘플에서는 원격 시스템에서 클래스의 하위 클래스를 검색하는 방법을 보여 줍니다.

$NameSpace = 'root\ccm'
$ComputerName = 'sccm.company.com'
$WbemLocator = New-Object -ComObject "WbemScripting.SWbemLocator"
$WbemServices = $WbemLocator.ConnectServer($ComputerName, $Namespace)
$WbemClasses = $WbemServices.SubclassesOf()
$WbemClasses

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
헤더	Wbemdisp.h
유형 라이브러리	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemServices
IID	IID_ISWbemServices

추가 정보

SWbemServices
SWbemObjectSet

다음을 통해 공유