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

  • Статья

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

Метод GetInstanceKeysByPath извлекает экземпляр, определенный путем к объекту, с заполнением только свойств ключа.

Синтаксис

HRESULT GetInstanceKeysByPath(
  LPCWSTR       pszInstancePath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

Параметры

pszInstancePath

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

ppInstance

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

pMethodContext

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

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

Возвращает 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

GetInstancePropertiesByPath