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

CWbemProviderGlue::GetInstanceByPath (wbemglue.h)

  • Статья

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

Метод GetInstanceByPath извлекает экземпляр, определенный определенным путем к объекту, путем вызова метода GetObject поставщика.

Синтаксис

HRESULT GetInstanceByPath(
  LPCWSTR       pszObjectPath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

Параметры

pszObjectPath

Путь к объекту для возвращаемого экземпляра.

ppInstance

Указатель на указатель на экземпляр CInstance, используемый для хранения нового экземпляра. Поставщик платформы, выполняющий запрос, должен освободить этот указатель.

pMethodContext

Указатель на текущий контекст. Для предотвращения взаимоблокировок необходимо указать контекст. Либо используйте контекст, переданный поставщику ::EnumerateInstances или Provider::ExecQuery, либо получите его из экземпляра с помощью CInstance::GetMethodContext. Этот параметр не должен иметь значение NULL.

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

Возвращает WBEM_S_NO_ERROR , если операция была успешной, WBEM_E_OUT_OF_MEMORY , если операция завершилась сбоем из-за нехватки памяти или другого кода ошибки HRESULT .

Комментарии

Метод GetInstanceByPath позволяет поставщикам платформы получать доступ к данным от другого поставщика без вызова API WMI. Поставщики платформы передают путь к объекту экземпляра в GetInstanceByPath, который возвращает экземпляр .

В текущей версии платформы поставщика pszInstancePath должен разрешаться как путь к экземпляру на том же компьютере.

Хотя pMethodContext имеет значение по умолчанию NULL, необходимо предоставить контекст для предотвращения взаимоблокировок. Либо используйте контекст, переданный поставщику ::EnumerateInstances или Provider::ExecQuery, либо получите его из экземпляра с помощью CInstance::GetMethodContext.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header wbemglue.h (включая FwCommon.h)
Библиотека FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll