Метод CWbemProviderGlue::GetInstancePropertiesByPath (wbemglue.h)
[Класс CWbemProviderGlue является частью платформы поставщика WMI, которая в настоящее время рассматривается в окончательном состоянии, и никакие дальнейшие разработки, улучшения или обновления не будут доступны для проблем, не связанных с безопасностью, влияющих на эти библиотеки. API mi mi следует использовать для всех новых разработок.]
Метод GetInstancePropertiesByPath извлекает экземпляр, определенный определенным путем к объекту, с заполненными только указанными свойствами. Заполняемые свойства именуются в массиве CHString .
Синтаксис
HRESULT GetInstancePropertiesByPath(
LPCWSTR pszInstancePath,
CInstance **ppInstance,
MethodContext *pMethodContext,
[ref] CHStringArray & csaProperties
);
Параметры
pszInstancePath
Путь объекта к возвращаемого экземпляра. Этот параметр должен указывать на полный путь.
ppInstance
Указатель на новый экземпляр CInstance , ключи которого указаны в pszInstancePath. Поставщик платформы, выполняющий запрос, должен освободить этот указатель.
pMethodContext
Указатель на текущий контекст. Для предотвращения взаимоблокировок необходимо указать контекст. Либо используйте контекст, переданный поставщику ::EnumerateInstances или Provider::ExecQuery, либо получите его из экземпляра с помощью CInstance::GetMethodContext. Этот параметр не должен иметь значение NULL.
[ref] csaProperties
Массив, содержащий имена свойств, копируемых в новый экземпляр.
Возвращаемое значение
Возвращает WBEM_S_NO_ERROR , если операция была успешной, WBEM_E_OUT_OF_MEMORY , если операция завершилась сбоем из-за нехватки памяти или другого кода ошибки HRESULT .
Комментарии
Этот метод использует операции частичного обновления экземпляра для запроса только указанных свойств указанного объекта. Это наиболее эффективный способ извлечения конкретного экземпляра, когда требуется больше свойств, чем только ключи. Имейте в виду, что не все поставщики поддерживают операции с частичными экземплярами. В этом случае заполняется весь экземпляр (включая ключи). Дополнительные сведения см. в разделе Поддержка операций Partial-Instance.
В текущей версии платформы поставщика pszInstancePath должен разрешаться как путь к экземпляру на том же компьютере.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | wbemglue.h (включая FwCommon.h) |
| Библиотека | FrameDyn.lib |
| DLL | FrameDynOS.dll; FrameDyn.dll |