다음을 통해 공유

Next 함수

BeginEnumeration을 호출하여 시작된 열거형의 next 속성을 검색합니다.

참고

이 API는 내부 전용입니다. 개발자 코드에서 사용할 수 없습니다.

구문

HRESULT Next (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lFlags,
   [out] BSTR*            pstrName,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

매개 변수

vFunc
[in] 이 매개 변수는 사용되지 않습니다.

ptr
[in] IWbemClassObject 인스턴스에 대한 포인터입니다.

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

pstrName
[out] 속성 이름을 포함하는 새 BSTR입니다. 이름이 필요하지 않은 경우 이 매개 변수를 null로 설정할 수 있습니다.

pVal
[out] 속성 값으로 채워진 VARIANT입니다. 값이 필요하지 않은 경우 이 매개 변수를 null로 설정할 수 있습니다. 함수가 오류 코드를 반환하는 경우 pVal에 전달된 VARIANT는 수정되지 않은 상태로 유지됩니다.

pvtType
[out] CIMTYPE 변수(속성 형식이 배치되는 LONG)에 대한 포인터입니다. 이 속성의 값은 VT_NULL_VARIANT일 수 있습니다. 이 경우 속성의 실제 형식을 확인해야 합니다. 이 매개 변수는 null일 수도 있습니다.

plFlavor
[out] null 또는 속성의 원본에 대한 정보를 수신하는 값입니다. 가능한 값은 [주의] 섹션을 참조하세요.

반환 값

이 함수가 반환하는 다음 값은 WbemCli.h 헤더 파일에 정의되어 있거나 코드에서 상수로 정의할 수 있습니다.

상수 값 Description
WBEM_E_FAILED 0x80041001 일반적인 오류가 발생했습니다.
WBEM_E_INVALID_PARAMETER 0x80041008 매개 변수가 잘못되었습니다.
WBEM_E_UNEXPECTED 0x8004101d BeginEnumeration 함수에 대한 호출이 없습니다.
WBEM_E_OUT_OF_MEMORY 0x80041006 새 열거형을 시작하는 데 사용할 수 있는 메모리가 충분하지 않습니다.
WBEM_E_TRANSPORT_FAILURE 0x80041015 현재 프로세스와 Windows Management 간의 원격 프로시저 호출이 실패했습니다.
WBEM_S_NO_ERROR 0 함수 호출에 성공했습니다.
WBEM_S_NO_MORE_DATA 0x40005 열거형에는 더 이상 속성이 없습니다.

설명

이 함수는 IWbemClassObject::Next 메서드에 대한 호출을 래핑합니다.

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

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

plFlavor가 null이 아니면 LONG 값은 다음과 같이 속성의 원본에 대한 정보를 받습니다.

상수 값 Description
WBEM_FLAVOR_ORIGIN_SYSTEM 0x40 이 속성은 표준 시스템 속성입니다.
WBEM_FLAVOR_ORIGIN_PROPAGATED 0x20 클래스의 경우: 속성은 부모 클래스에서 상속됩니다.
인스턴스의 경우: 부모 클래스에서 상속된 속성은 인스턴스에서 수정되지 않았습니다.
WBEM_FLAVOR_ORIGIN_LOCAL 0 클래스의 경우: 속성은 파생 클래스에 속합니다.
인스턴스의 경우: 인스턴스에 의해 속성이 수정됩니다. 즉, 값이 제공되었거나 한정자가 추가 또는 수정되었습니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: WMINet_Utils.idl

.NET Framework 버전: 4.7.2부터 사용 가능

참고 항목

  • Last updated on