Метод 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 |