Метод CWbemProviderGlue::GetInstancePropertiesByPath (wbemglue.h)

Статья
03/03/2024

[Класс 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

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

CWbemProviderGlue

GetInstanceByPath

GetInstanceKeysByPath