개체 한정자의 열거자를 열거형 시작 부분으로 다시 설정합니다.
참고
이 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부터 사용 가능
참고 항목
.NET