IWbemClassObject::Next 메서드(wbemcli.h)

아티클
08/27/2023

IWbemClassObject::Next 메서드는 IWbemClassObject::BeginEnumeration으로 시작된 열거형에서 다음 속성을 검색합니다. WBEM_S_NO_MORE_DATA 반환될 때까지 모든 속성을 열거하기 위해 반복적으로 호출해야 합니다. 열거형을 일찍 종료하려면 IWbemClassObject::EndEnumeration 을 호출해야 합니다.

열거형 중에 반환된 속성의 순서가 정의되지 않았습니다.

구문

HRESULT Next(
  [in]            long    lFlags,
  [out]           BSTR    *strName,
  [out]           VARIANT *pVal,
  [out, optional] CIMTYPE *pType,
  [out, optional] long    *plFlavor
);

매개 변수

[in] lFlags

예약되어 있습니다. 이 매개 변수는 0이어야 합니다.

[out] strName

속성 이름이 포함된 새 BSTR 을 받습니다. 클라이언트 프로세스에서 메모리 누수 방지를 위해 호출자는 이름이 더 이상 필요하지 않을 때 SysFreeString 을 호출해야 합니다. 이름이 필요하지 않은 경우 이 매개 변수를 NULL 로 설정할 수 있습니다.

[out] pVal

이 VARIANT 는 속성 값으로 채워집니다. 메서드는 이 VARIANT에서 VariantInit를 호출하므로 호출자는 호출 전에 VARIANT가 활성 상태가 아닌지 확인해야 합니다. 값이 더 이상 필요하지 않은 경우 호출자는 VariantClear 를 사용해야 합니다.

값이 필요하지 않은 경우 이 매개 변수를 NULL 로 설정할 수 있습니다. 오류 코드가 반환되면 pVal이 가리키는 VARIANT는 수정되지 않은 상태로 남습니다.

[out, optional] pType

이 매개 변수는 NULL일 수 있습니다. NULL이 아닌 경우 속성의 형식이 배치되는 CIMTYPE 변수(LONG)를 가리킵니다. 이 속성의 값은 VT_NULLVARIANT일 수 있습니다. 이 경우 속성의 실제 형식을 확인해야 합니다.

[out, optional] plFlavor

NULL일 수 있습니다. NULL이 아닌 경우 가리키는 LONG 값은 다음과 같이 속성의 원본에 대한 정보를 받습니다. 자세한 내용은 한정자 버전 및 WBEM_FLAVOR_TYPE 참조 하세요.

WBEM_FLAVOR_ORIGIN_SYSTEM

이 속성은 표준 시스템 속성입니다.

클래스:

WBEM_FLAVOR_ORIGIN_PROPAGATED

속성은 부모 클래스에서 상속되었습니다.

속성은 부모 클래스에서 상속되지만 instance 수준에서 수정되지 않았습니다.

WBEM_FLAVOR_ORIGIN_LOCAL

속성은 가장 많이 파생된 클래스에 속합니다.

속성은 instance 수준에서 수정됩니다(즉, 값이 제공되었거나 한정자가 추가/수정됨).

인스턴스:

반환 값

이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT 내에 포함된 값이 나열되어 있습니다. 일반적인 HRESULT 값은시스템 오류 코드를 참조하세요.

설명

속성의 기본 형식이 개체 경로, 날짜 또는 시간 또는 다른 특수 형식인 경우 반환된 형식에 충분한 정보가 포함되지 않습니다. 호출자는 지정된 속성에 대한 CIMTYPE 을 검사하고 속성이 개체 참조, 날짜 또는 시간 또는 다른 특수 형식인지 확인해야 합니다.

이 메서드는 시스템 속성도 반환합니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	wbemcli.h(Wbemidl.h 포함)
라이브러리	WbemUuid.lib
DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll