Método IWbemCallResult::GetResultObject (wbemcli.h)

  • Artículo

El método IWbemCallResult::GetResultObject intenta recuperar un objeto de una llamada semisynchronous anterior a IWbemServices::GetObject o IWbemServices::ExecMethod. Si el objeto aún no está disponible, la llamada devuelve WBEM_S_TIMEDOUT. Además, antes de invocar este método para obtener el objeto resultante, puede llamar a IWbemCallResult::GetCallStatus hasta que devuelva WBEM_S_NO_ERROR, lo que indica que se ha completado la operación semiincrónica original.

Sintaxis

HRESULT GetResultObject(
  [in]  long             lTimeout,
  [out] IWbemClassObject **ppResultObject
);

Parámetros

[in] lTimeout

Especifica el tiempo máximo en milisegundos que esta llamada bloquea antes de devolver. Si usa la constante WBEM_INFINITE (0xFFFFFFFF), la llamada se bloquea hasta que el objeto esté disponible. Si usa 0, la llamada devuelve inmediatamente el objeto o un código de estado.

[out] ppResultObject

Este parámetro no puede ser NULL. Recibe la copia del objeto cuando está disponible. Debe llamar a IWbemClassObject::Release en el objeto devuelto cuando el objeto ya no es necesario. No se devuelve un nuevo objeto cuando se produce un error.

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 produjo un error en la operación semiincrónica original (por ejemplo, cuando no se encontró el objeto o no se pudo invocar el método), este método devuelve el código de error que la función original habría devuelto en su versión sincrónica.

En caso de error, puede llamar a la función COM GetErrorInfo para obtener más información de error.

También se pueden devolver códigos de error específicos de COM si los problemas de red hacen que pierdas la conexión remota a la 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)

Consulte también

IWbemCallResult

IWbemServices::ExecMethod

IWbemServices::GetObject