다음을 통해 공유


QualifierSet_BeginEnumeration 함수

개체 한정자의 열거자를 열거형 시작 부분으로 다시 설정합니다.

참고

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

구문

HRESULT QualifierSet_BeginEnumeration (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags
);

매개 변수

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

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

lFlags
[in] 열거형에 포함할 한정자를 지정하는 비고 섹션에 설명된 플래그 또는 값의 비트 조합입니다.

반환 값

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

상수 Description
WBEM_E_INVALID_PARAMETER 0x80041008 lFlags 매개 변수가 잘못된 경우
WBEM_E_UNEXPECTED 0x8004101d QualifierSet_EndEnumeration에 대한 중간 호출 없이 QualifierSet_BeginEnumeration에 대한 두 번째 호출이 이루어졌습니다.
WBEM_E_OUT_OF_MEMORY 0x80041006 새 열거형을 시작하는 데 사용할 수 있는 메모리가 충분하지 않습니다.
WBEM_S_NO_ERROR 0 함수 호출에 성공했습니다.

설명

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

개체의 모든 한정자를 열거하려면 QualifierSet_Next를 처음 호출하기 전에 이 메서드를 호출해야 합니다. 한정자가 열거되는 순서는 지정된 열거형에 대해 변하지 않는 것이 보장됩니다.

lEnumFlags 인수로 전달할 수 있는 플래그는 WbemCli.h 헤더 파일에 정의되거나 코드에서 상수로 정의할 수 있습니다.

상수 설명
0 모든 한정자의 이름을 반환합니다.
WBEM_FLAG_LOCAL_ONLY 0x10 현재 속성 또는 개체와 관련된 한정자의 이름만 반환합니다.
속성의 경우: 속성에 특정한 한정자(재정의 포함)만 반환하고 클래스 정의에서 전파된 한정자는 반환하지 않습니다.
인스턴스의 경우: 인스턴스별 한정자 이름만 반환합니다.
클래스의 경우: 파생되는 클래스와 관련된 한정자만 반환합니다.
WBEM_FLAG_PROPAGATED_ONLY 0x20 다른 개체에서 전파된 한정자의 이름만 반환합니다.
속성의 경우: 속성 자체에서가 아니라 클래스 정의에서 이 속성으로 전파된 한정자만 반환합니다.
예를 들어: 클래스 정의에서 전파된 한정자만 반환합니다.
클래스의 경우: 부모 클래스에서 상속된 한정자 이름만 반환합니다.

요구 사항

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

헤더: WMINet_Utils.idl

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

참고 항목