IWbemQualifierSet::Next 메서드(wbemcli.h)
IWbemQualifierSet::Next 메서드는 IWbemQualifierSet::BeginEnumeration으로 시작된 열거형에서 다음 한정자를 검색합니다. 이 메서드는 WBEM_S_NO_MORE_DATA 반환될 때까지 모든 한정자를 열거하기 위해 반복적으로 호출됩니다. 열거형을 일찍 종료하려면 IWbemQualifierSet::EndEnumeration을 호출합니다.
열거형 중에 반환된 한정자의 순서가 정의되지 않았습니다.
구문
HRESULT Next(
[in] long lFlags,
[out] BSTR *pstrName,
[out] VARIANT *pVal,
[out] long *plFlavor
);
매개 변수
[in] lFlags
예약되어 있습니다. 이 매개 변수는 0이어야 합니다.
[out] pstrName
이 매개 변수는 한정자의 이름을 받습니다. 새 BSTR 은 WBEM_S_NO_ERROR 반환할 때마다 항상 할당됩니다.
pstrName이 NULL이면 무시됩니다. 그렇지 않으면 호출자는 이 매개 변수가 항목에서 유효한 BSTR을 가리키지 않도록 해야 합니다. 그렇지 않으면 메모리 누수가 발생합니다. 또한 호출자는 더 이상 필요하지 않은 경우 반환된 문자열에서 SysFreeString 을 호출해야 합니다.
[out] pVal
이 매개 변수는 한정자의 값을 받습니다. VariantInit 는 이 메서드에 의해 VARIANT 에서 호출됩니다. 값이 더 이상 필요하지 않은 경우 호출자는 이 포인터에서 VariantClear 를 호출해야 합니다. 오류 코드가 반환되면 pVal이 가리키는 VARIANT는 수정되지 않은 상태로 남습니다. 이 매개 변수는 NULL로 설정된 경우 무시됩니다.
[out] plFlavor
NULL이 아니면 가리키는 값이 한정자 버전으로 설정됩니다. 자세한 내용은 한정자 버전 및 WBEM_FLAVOR_TYPE 참조 하세요.
반환 값
이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT 내에 포함된 값이 나열되어 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | wbemcli.h(Wbemidl.h 포함) |
| 라이브러리 | Wbemuuid.lib |
| DLL | Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll |
추가 정보
IWbemQualifierSet::BeginEnumeration