Método IWbemServices::GetObject (wbemcli.h)

Artículo
03/08/2023

El método IWbemServices::GetObject recupera una clase o instancia. Este método solo recupera objetos del espacio de nombres asociado al objeto IWbemServices actual.

Sintaxis

HRESULT GetObject(
  [in]  const BSTR       strObjectPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pCtx,
  [out] IWbemClassObject **ppObject,
  [out] IWbemCallResult  **ppCallResult
);

Parámetros

[in] strObjectPath

Ruta de acceso del objeto que se va a recuperar. Si es NULL, se devuelve un objeto vacío que puede convertirse en una nueva clase. Para obtener más información, consulte Crear una clase.

[in] lFlags

Las marcas siguientes afectan al comportamiento de este método.

WBEM_FLAG_USE_AMENDED_QUALIFIERS

Si se establece esta marca, WMI recupera los calificadores modificados almacenados en el espacio de nombres localizado de la configuración regional de la conexión actual. Si no se establece, solo se recuperan los calificadores almacenados en el espacio de nombres inmediato.

WBEM_FLAG_RETURN_WBEM_COMPLETE

Esta marca hace que esta llamada sea sincrónica.

WBEM_FLAG_RETURN_IMMEDIATELY

Esta marca convierte esta llamada semiincrónica. Debe proporcionar un puntero válido para el parámetro ppCallResult . Para más información, vea Llamada a un método.

WBEM_FLAG_DIRECT_READ

Esta marca provoca el acceso directo al proveedor de la clase especificada sin tener en cuenta su clase o subclases primarias.

[in] pCtx

Normalmente , NULL. De lo contrario, se trata de un puntero a un objeto IWbemContext que puede usar el proveedor que está produciendo la clase o instancia solicitadas. Los valores del objeto de contexto deben especificarse en la documentación del proveedor en cuestión. Para obtener más información sobre este parámetro, vea Realizar llamadas a WMI.

[out] ppObject

Si no es NULL, este recibe el objeto , si se encuentra. El objeto devuelto tiene un recuento de referencias positivo. El autor de la llamada debe usar Release cuando el objeto ya no sea necesario. En todos los casos de error, este parámetro se establece para que apunte a NULL.

[out] ppCallResult

Si es NULL, este parámetro no se usa. Si el parámetro lFlags contiene WBEM_FLAG_RETURN_IMMEDIATELY, esta llamada devuelve inmediatamente con WBEM_S_NO_ERROR. El parámetro ppCallResult recibe un puntero a un nuevo objeto IWbemCallResult , que luego se puede sondear para obtener el resultado mediante el método GetCallStatus . El autor de la llamada puede llamar a IWbemCallResult::GetResultObject para recuperar el objeto cuando esté disponible.

Valor devuelto

Este método devuelve un valor HRESULT que indica el estado de la llamada al método. En la lista siguiente se muestra el valor contenido en un HRESULT.

Si se produce un error, puede obtener cualquier información disponible de la función COM GetErrorInfo.

También se pueden devolver códigos de error específicos de COM si los problemas de red hacen que pierda la conexión remota a administración de Windows.

Requisitos


Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemcli.h (include Wbemidl.h)
Library	Wbemuuid.lib
Archivo DLL	Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll