Método CWbemProviderGlue::GetEmptyInstance(MethodContext*,LPCWSTR,CInstance**,LPCWSTR) (wbemglue.h)

[La clase CWbemProviderGlue forma parte del marco de proveedor de WMI que ahora se considera en estado final y no habrá más trabajo de desarrollo, mejoras ni actualizaciones disponibles para problemas no relacionados con la seguridad que afecten a estas bibliotecas. Para el trabajo de desarrollo nuevo, deben usarse las API de MI.]

El método GetEmptyInstance recupera una única instancia sin rellenar de la clase especificada.

Sintaxis

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

Parámetros

pMethodContext

Puntero al contexto actual.

pszClassName

Nombre de la clase cuya instancia se va a devolver.

ppInstance

Puntero a una instancia de la clase CInstance utilizada para almacenar la nueva instancia. El proveedor de marcos debe liberar este puntero que llama a GetEmptyInstance.

pszNamespace

Espacio de nombres del nombre de clase especificado por pszClassName. Este parámetro puede ser NULL para indicar el espacio de nombres predeterminado, que es root\cimv2.

Valor devuelto

Devuelve WBEM_S_NO_ERROR si la operación se realizó correctamente, WBEM_E_OUT_OF_MEMORY si se produjo un error en la operación debido a la falta de memoria o a cualquier otro código de error HRESULT .

Comentarios

El proveedor de marcos pasa el nombre del proveedor a GetEmptyInstance, que devuelve una instancia vacía. Un uso común de este método es rellenar una propiedad de objeto incrustada. Este método se usa junto con CInstance::SetEmbeddedObject.

No se recomienda el segundo prototipo de función. Solo se proporciona para admitir código existente.

Requisitos

Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemglue.h (incluya FwCommon.h)
Library	FrameDyn.lib
Archivo DLL	FrameDynOS.dll; FrameDyn.dll