Compartir a través de

CWbemProviderGlue::GetInstancesByQuery(LPCWSTR,TRefPointerCollection<CInstance>*,MethodContext*,LPCWSTR) (wbemglue.h)

  • Artículo

[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 GetInstancesByQuery recupera una lista de instancias que coinciden con una consulta determinada.

Sintaxis

HRESULT GetInstancesByQuery(
  LPCWSTR                          query,
  TRefPointerCollection<CInstance> *pList,
  MethodContext                    *pMethodContext,
  LPCWSTR                          pszNamespace
);

Parámetros

query

Consulta que se va a ejecutar.

pList

Lista vinculada de instancias que coinciden con la consulta especificada por Query.

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 úselo de la instancia mediante CInstance::GetMethodContext. Este parámetro no debe ser NULL.

pszNamespace

Puntero al espacio de nombres que contiene las instancias. Si es NULL, se usa el espacio de nombres predeterminado, raíz\cimv2.

Valor devuelto

El método devuelve WBEM_S_NO_ERROR si la operación se realizó correctamente, WBEM_E_FAILED si se produjo un error en la operación o cualquier otro código de error HRESULT .

Comentarios

El método GetInstancesByQuery permite a los proveedores de marcos acceder a los datos de otros proveedores sin tener que realizar una llamada API de WMI. Los proveedores de marcos pasan una consulta a GetInstancesByQuery, que devuelve las instancias adecuadas.

Por motivos de rendimiento, al llamar a esta función, especifique solo las propiedades que necesita (por ejemplo, especifique "SELECT name" en lugar de "SELECT *").

Requisitos

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