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

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

Метод GetEmptyInstance извлекает один незаселенный экземпляр указанного класса.

Синтаксис

HRESULT GetEmptyInstance(
  MethodContext *pMethodContext,
  LPCWSTR       pszClassName,
  CInstance     **ppInstance,
  LPCWSTR       pszNamespace
);

Параметры

pMethodContext

Указатель на текущий контекст.

pszClassName

Имя класса, экземпляр которого должен быть возвращен.

ppInstance

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

pszNamespace

Пространство имен класса, указанное в параметре pszClassName. Этот параметр может иметь значение NULL , чтобы указать пространство имен по умолчанию— root\cimv2.

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

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

Комментарии

Поставщик платформы передает имя поставщика в GetEmptyInstance, который возвращает пустой экземпляр. Этот метод часто используется для заполнения свойства внедренного объекта. Этот метод используется совместно с CInstance::SetEmbeddedObject.

Второй прототип функции не рекомендуется. Он предоставляется только для поддержки существующего кода.

Требования

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