CFrameworkQuery::GetValuesForProp(LPCWSTR,CHStringArray&) 메서드(frquery.h)

[CFrameworkQuery 클래스는 WMI 공급자 프레임워크의 일부이며 현재 최종 상태로 간주됩니다. 이 라이브러리에 영향을 미치는 보안과 관련되지 않은 문제에 대해서는 더 이상 개발, 개선 또는 업데이트가 이루어지지 않습니다. 모든 새로운 개발에서는 MI API를 사용해야 합니다.]

GetValuesForProp 메서드는 쿼리 내에 나타날 때 해당 속성에 의해 생성된 특정 속성에 대한 모든 값을 반환합니다.

예를 들어 GetValuesForProp(L"Name", sa)에 대한 호출은 sa 배열을 반환합니다. 여기에는 쿼리를 만족시키기 위해 인스턴스를 다시 보내야 하는 "이름"의 모든 값이 포함됩니다. sa에 {"a","b"}가 포함된 경우 "Name=a"인 모든 인스턴스와 "Name=b"인 모든 인스턴스를 다시 보내야 쿼리를 완전히 충족할 수 있습니다.

"이름"에 대한 제약 조건이 충분히 제한되지 않으면 빈 sa 배열이 반환됩니다.

구문

HRESULT GetValuesForProp(
  LPCWSTR         wszPropName,
  CHStringArray & achNames
);

매개 변수

wszPropName

wszPropName으로 지정된 속성의 값 배열입니다.

achNames

대상 속성의 이름입니다.

반환 값

이 메서드는 성공 시 WBEM_S_NO_ERROR 반환하고 실패 시 WBEM_E_FAILED 또는 다른 HRESULT 오류 코드를 반환합니다.

설명

속성 이름이 지정되면 이 메서드는 CHStringArray 또는 벡터 컨테이너의 모든 결과 값을 반환합니다. 벡터 컨테이너는 결과 값을 포함하는 _bstr_t 개체를 보유합니다.

예를 들어 다음 목록에서는 wszPropName을 "Drive"로 설정하여 호출할 때 다양한 쿼리에 대해 GetValuesForProp에서 반환하는 값을 나열합니다.

쿼리	반환 값	결과
SELECT * FROMWin32_Directory 어디 드라이브 = "C:"	WBEM_S_NO_ERROR	C:
SELECT * FROMWin32_Directory 어디 드라이브 = "C:" OR FileSize = 256	WBEM_S_NO_ERROR	결과가 없습니다. aszNames 가 비어 있습니다.
SELECT * FROMWin32_Directory 어디 드라이브 = "C:" OR 드라이브 = "D:"	WBEM_S_NO_ERROR	C:, D:
SELECT * FROMWin32_Directory 어디 드라이브 <> "C:"	WBEM_S_NO_ERROR	결과가 없습니다. aszNames 가 비어 있습니다.
SELECT * FROMWin32_Directory WHERE경로 = "\DOS"	WBEM_S_NO_ERROR	결과가 없습니다. aszNames 가 비어 있습니다.

 

GetValuesForProp 메서드는 문자열 형식만 지원합니다. 예를 들어 다음 쿼리와 GetValuesForProp("PropInt", values)를 호출한 후 WBEM_E_INVALID_QUERY 반환하고 GetValuesForProp("PropStr", values)는 S_OK 반환합니다.

SELECT * FROM Test WHERE PropInt = 32 AND PropStr = "a"

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	frquery.h(FwCommon.h 포함)
라이브러리	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll

추가 정보

CFrameworkQuery

Provider::ExecQuery