Share via

Метод CWbemProviderGlue::GetInstanceByPath(LPCWSTR,CInstance**,MethodContext*) (wbemglue.h)

  • Статья

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

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

Синтаксис

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

Параметры

pszObjectPath

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

ppInstance

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

pMethodContext

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

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

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

Комментарии

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

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

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

Требования

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