Método IWbemServices::GetObject (wbemcli.h)
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 |