Метод CFrameworkQuery::GetValuesForProp(LPCWSTR,CHStringArray&) (frquery.h)

[Класс CFrameworkQuery является частью платформы поставщика WMI, которая теперь рассматривается в окончательном состоянии, и никакие дальнейшие разработки, улучшения или обновления не будут доступны для проблем, не связанных с безопасностью, влияющих на эти библиотеки. API mi mi следует использовать для всех новых разработок.]

Метод GetValuesForProp возвращает все значения для определенного свойства, созданные этим свойством, как оно отображается в запросе.

Например, вызов Метода GetValuesForProp(L"Name", sa) возвращает массив sa, содержащий все значения "Name", которые требуют отправки экземпляров обратно для удовлетворения запроса. Если sa содержит {"a", "b"}, то для полного удовлетворения запроса необходимо отправить все экземпляры, где "Name=a", а также все экземпляры , где "Name=b" должны быть отправлены обратно.

Если ограничения на "Name" недостаточно ограничены, возвращается пустой массив sa .

Синтаксис

HRESULT GetValuesForProp(
  LPCWSTR         wszPropName,
  CHStringArray & achNames
);

Параметры

wszPropName

Массив значений для свойства, заданного wszPropName.

achNames

Имя целевого свойства.

Возвращаемое значение

Этот метод возвращает WBEM_S_NO_ERROR об успешном выполнении и WBEM_E_FAILED или любой другой код ошибки HRESULT при сбое.

Комментарии

При указании имени свойства этот метод возвращает все значения результатов в контейнере CHStringArray или vector. Контейнер векторов содержит _bstr_t объектов, содержащих значения результатов.

Например, в следующем списке перечислены значения, возвращаемые Командой GetValuesForProp для различных запросов при вызове с параметром wszPropName , для которых задано значение Drive.

Запрос	Возвращаемое значение	Результат
SELECT * FROMWin32_Directory ГДЕ Диск = "C:"	WBEM_S_NO_ERROR	В.
SELECT * FROMWin32_Directory ГДЕ Диск = "C:" OR FileSize = 256	WBEM_S_NO_ERROR	Нет результатов; aszNames пуст.
SELECT * FROMWin32_Directory ГДЕ Drive = "C:" OR Drive = "D:"	WBEM_S_NO_ERROR	C:, D:
SELECT * FROMWin32_Directory ГДЕ Диск <> "C:"	WBEM_S_NO_ERROR	Нет результатов; aszNames пуст.
SELECT * FROMWin32_Directory WHEREPath = "\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
Header	frquery.h (включая FwCommon.h)
Библиотека	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll

См. также раздел

CFrameworkQuery

Provider::ExecQuery