SWbemObject.Instances_ 메서드

SWbemObject 개체의 Instances_ 메서드는 현재 클래스 개체의 인스턴스를 반환하는 열거자를 만듭니다. 이 메서드는 간단한 쿼리를 구현합니다. 보다 복잡한 쿼리는 SWbemServices.ExecQuery를 사용해야 할 수 있습니다.

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

구문

objWbemObjectSet = .Instances_( _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

매개 변수

iFlags [in, optional]

호출의 동작을 결정하는 정수입니다. 이 매개 변수는 다음 값을 허용할 수 있습니다.

wbemFlagForwardOnly(32(0x20))

정방향 전용 열거자가 반환되도록 합니다. 정방향 전용 열거자는 일반적으로 기존 열거자보다 훨씬 빠르고 메모리를 덜 사용하지만 SWbemObject.Clone_에 대한 호출을 허용하지 않습니다.

wbemFlagBidirectional(0(0x0))

클라이언트가 열거자를 해제할 때까지 WMI가 열거형 개체에 대한 포인터를 유지하도록 합니다.

wbemFlagReturnImmediately(16(0x10))

이 매개 변수의 기본값입니다. 이 플래그는 호출이 즉시 반환되도록 합니다.

wbemFlagReturnWhenComplete( 0 (0x0))

쿼리가 완료될 때까지 이 호출이 차단되도록 합니다.

wbemQueryFlagShallow(1 (0x1))

지정된 부모 클래스의 직계 하위 클래스만 포함하도록 열거형에 강제 적용합니다.

wbemQueryFlagDeep (0 (0x0))

이 매개 변수의 기본값입니다. 이 값은 열거형이 계층 구조의 모든 클래스를 포함하도록 합니다.

wbemFlagUseAmendedQualifiers(131072(0x20000))

WMI가 기본 클래스 정의와 함께 클래스 수정 데이터를 반환하도록 합니다.

objwbemNamedValueSet [in, optional]

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

반환 값

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

오류 코드

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

wbemErrAccessDenied - 2147749891(0x80041003)

현재 사용자는 지정된 클래스의 인스턴스를 볼 수 있는 권한이 없습니다.

wbemErrFailed - 2147749889(0x80041001)

지정되지 않은 오류가 발생했습니다.

wbemErrInvalidClass - 2147749904(0x80041010)

지정된 클래스가 잘못되었습니다.

wbemErrInvalidParameter - 2147749896(0x80041008)

지정된 매개 변수가 잘못되었습니다.

wbemErrOutOfMemory - 2147749894(0x80041006)

메모리가 부족하여 작업을 완료할 수 없습니다.

설명

Instances_ 메서드는 클래스 개체에 대해서만 작동합니다. 반환된 컬렉션에 제로 요소가 있는 것은 오류가 아닙니다. 이 메서드의 기본 동작은 기본 IFlags 값 wbemFlagReturnImmediately로 인해 semisynchronous’반동기적’입니다.

요구 사항

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

추가 정보

SWbemObject

SWbemObjectSet