Compartir a través de


Método CWbemProviderGlue::GetAllInstances (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. Las API de MI se deben usar para todo el nuevo desarrollo.]

El método GetAllInstances recupera una lista de instancias devueltas por una clase específica.

Sintaxis

HRESULT GetAllInstances(
  LPCWSTR                          pszClassName,
  TRefPointerCollection<CInstance> *pList,
  LPCWSTR                          pszNamespace,
  MethodContext                    *pMethodContext
);

Parámetros

pszClassName

Nombre de la clase para la que se debe devolver una lista de instancias.

pList

Lista vinculada de instancias admitidas por el proveedor especificado por pszClassName.

pszNamespace

Espacio de nombres del proveedor especificado por pszClassName. Este parámetro puede ser NULL para indicar el espacio de nombres predeterminado, que es "Root\CIMv2".

pMethodContext

Puntero al contexto actual. Se debe proporcionar un contexto para evitar interbloqueos. Use el contexto pasado al proveedor por Provider::EnumerateInstances o Provider::ExecQuery, o bien obtengalo de la instancia mediante CInstance::GetMethodContext. Este parámetro no debe ser NULL.

Valor devuelto

El método 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 método GetAllInstances permite a los proveedores de marcos acceder a datos de otro proveedor sin tener que realizar una llamada API de WMI. Los proveedores de marcos pasan el nombre del proveedor a GetAllInstances, que devuelve una lista de todas las instancias que admite el proveedor.

Este método es semánticamente equivalente a la consulta SELECT * FROM pszBaseClassName WHERE __Class = pszBaseClassName.

Requisitos

Requisito Value
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