다음을 통해 공유

QualifierSet_Next 함수

QualifierSet_BeginEnumeration 함수를 호출하여 시작된 열거형의 다음 한정자를 검색합니다.

참고

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

구문

HRESULT QualifierSet_Next (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] BSTR*               pstrName,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

매개 변수

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

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

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

pstrName [out] 한정자의 이름입니다. null인 경우 이 매개 변수는 무시되고, 그렇지 않으면 pstrName이 유효한 BSTR을 가리키지 않아야 합니다. 그렇지 않으면 메모리 누수가 발생합니다. null이 아닌 경우 함수는 WBEM_S_NO_ERROR를 반환할 때 항상 새 BSTR을 할당합니다.

pVal [out] 성공하면 한정자의 값입니다. 함수가 실패하면 pVal이 가리킨 VARIANT는 수정되지 않습니다. 이 매개 변수가 null인 경우, 매개 변수는 무시됩니다.

plFlavor [out] 한정자 특성을 수신하는 LONG에 대한 포인터입니다. 버전 정보를 원치 않을 경우 이 매개 변수는 null일 수 있습니다.

반환 값

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

상수 값 Description
WBEM_E_INVALID_PARAMETER 0x80041008 매개 변수가 잘못된 경우
WBEM_E_UNEXPECTED 0x8004101d 호출자가 QualifierSet_BeginEnumeration을 호출하지 않았습니다.
WBEM_E_OUT_OF_MEMORY 0x80041006 새 열거형을 시작하는 데 사용할 수 있는 메모리가 충분하지 않습니다.
WBEM_S_NO_MORE_DATA 0x40005 더 이상 한정자는 열거형에 남아 있지 않습니다.
WBEM_S_NO_ERROR 0 함수 호출에 성공했습니다.

설명

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

QualifierSet_Next 함수가 WBEM_S_NO_MORE_DATA를 반환할 때까지 이 함수를 반복적으로 호출하여 모든 한정자를 열거합니다. 열거형을 일찍 종료하려면 QualifierSet_EndEnumeration 함수를 호출합니다.

열거 중에 반환되는 한정자의 순서는 정의되지 않습니다.

요구 사항

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

헤더: WMINet_Utils.idl

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

참고 항목

  • Last updated on