다음을 통해 공유

QualifierSet_GetNames 함수

현재 개체 또는 속성에서 사용할 수 있는 모든 한정자 또는 지정된 한정자의 이름을 검색합니다.

참고

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

구문

HRESULT QualifierSet_GetNames (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] SAFEARRAY (BSTR)**  pstrNames
);

매개 변수

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

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

lFlags
[in] 열거형에 포함할 이름을 지정하는 다음 플래그 또는 값 중 하나입니다.

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

pstrNames
[out] 요청된 이름을 포함하는 새 SAFEARRAY 항목입니다. 배열에는 0개의 요소가 있을 수 있습니다. 오류가 발생하면 새 SAFEARRAY 항목이 반환되지 않습니다.

반환 값

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

상수 값 Description
WBEM_E_INVALID_PARAMETER 0x80041008 매개 변수가 잘못된 경우
WBEM_E_OUT_OF_MEMORY 0x80041006 새 열거형을 시작하는 데 사용할 수 있는 메모리가 충분하지 않습니다.
WBEM_S_NO_ERROR 0 함수 호출에 성공했습니다.

설명

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

한정자 이름을 검색한 후에는 QualifierSet_Get 함수를 호출하여 이름으로 각 한정자에 액세스할 수 있습니다.

지정된 개체에 한정자가 0인 것은 오류가 아니므로 함수가 WBEM_S_NO_ERROR를 반환하더라도 반환 시 pstrNames의 문자열 수는 0이 될 수 있습니다.

요구 사항

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

헤더: WMINet_Utils.idl

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

참고 항목

  • Last updated on