CWbemProviderGlue::GetInstanceByPath(LPCWSTR,CInstance**,MethodContext*) (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 GetInstanceByPath recupera la instancia identificada por una ruta de acceso de objeto determinada mediante una llamada al método GetObject del proveedor.

Sintaxis

HRESULT GetInstanceByPath(
  LPCWSTR       pszObjectPath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

Parámetros

pszObjectPath

Ruta de acceso de objeto a la instancia que se va a devolver.

ppInstance

Puntero a un puntero a una instancia de CInstance utilizada para almacenar la nueva instancia. El proveedor de marcos que realiza la solicitud debe liberar este puntero.

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

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 GetInstanceByPath permite a los proveedores de marcos acceder a datos de otro proveedor sin necesidad de una llamada API de WMI. Los proveedores de marcos pasan la ruta de acceso del objeto de una instancia a GetInstanceByPath, que devuelve la instancia.

En la versión actual del marco de trabajo del proveedor, pszInstancePath debe resolverse para que sea una ruta de acceso de instancia en el mismo equipo.

Aunque pMethodContext tiene un valor predeterminado de NULL, 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.

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