Поделиться через

Метод 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