IWbemQualifierSet::GetNames 메서드(wbemcli.h)
IWbemQualifierSet::GetNames 메서드는 현재 개체 또는 속성에서 사용할 수 있는 모든 한정자의 이름을 검색합니다. 또는 IFlags의 필터 값에 따라 이 메서드는 특정 한정자의 이름을 검색합니다.
각 이름에 대해 IWbemQualifierSet::Get 을 사용하여 이름으로 이러한 한정자에 액세스할 수 있습니다. 지정된 개체에 한정자 0이 있는 것은 오류가 아니므로 반환할 때 pstrNames 의 문자열 수는 WBEM_S_NO_ERROR 반환되더라도 0일 수 있습니다.
구문
HRESULT GetNames(
[in] long lFlags,
[out] SAFEARRAY **pNames
);
매개 변수
[in] lFlags
다음 상수 중 하나입니다.
0(0)
모든 한정자의 이름을 반환합니다.
WBEM_FLAG_LOCAL_ONLY
현재 속성 또는 개체와 관련된 한정자의 이름만 반환합니다. 현재 한정자 집합이 속성을 참조하는 경우 속성과 관련된 한정자(재정의 포함)만 반환하고 클래스 정의에서 전파된 한정자만 반환하지 않습니다. 현재 한정자 집합이 instance 참조하는 경우 instance 특정 한정자 이름만 반환합니다. 현재 한정자 집합이 클래스를 참조하는 경우 파생되는 클래스와 관련된 한정자만 반환합니다.
WBEM_FLAG_PROPAGATED_ONLY
다른 개체에서 전파된 한정자의 이름만 반환합니다. 예를 들어 현재 한정자 집합이 속성을 참조하는 경우 클래스 정의에서 이 속성으로 전파된 한정자만 반환하고 속성 자체의 한정자만 반환하지 않습니다. 현재 한정자 집합이 instance 참조하는 경우 클래스 정의에서 전파된 한정자만 반환합니다. 현재 한정자 집합이 클래스를 참조하는 경우 부모 클래스에서 상속된 한정자 이름만 반환합니다.
[out] pNames
요청된 이름을 포함하는 새 SAFEARRAY 가 만들어집니다.
오류가 반환되지 않는 모든 경우 새 배열이 만들어지고 pstrNames 가 해당 배열을 가리키도록 설정됩니다. 결과 배열에 요소가 0인 경우에도 발생합니다. 오류 발생시 새 SAFEARRAY 가 반환되지 않습니다.
반환 값
이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT 내에 포함된 값이 나열되어 있습니다.
설명
BSTR의 SAFEARRAY를 사용하는 예제는 WMI 인스턴스의 일부 검색을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | wbemcli.h(Wbemidl.h 포함) |
| 라이브러리 | Wbemuuid.lib |
| DLL | Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll |