Método IVssAsync::QueryStatus (vss.h)

Artículo
08/27/2023

El método QueryStatus consulta el estado de una operación asincrónica.

Sintaxis

HRESULT QueryStatus(
  [out] HRESULT *pHrResult,
  [out] INT     *pReserved
);

Parámetros

[out] pHrResult

Estado de la operación asincrónica que devolvió el objeto IVssAsync actual.

Todas las llamadas a QueryStatus para todos los objetos IVssAsync admiten los siguientes códigos de estado.

Value	Significado
VSS_S_ASYNC_CANCELLED	La operación asincrónica se canceló mediante una llamada anterior a IVssAsync::Cancel.
VSS_S_ASYNC_FINISHED	La operación asincrónica se completó correctamente.
VSS_S_ASYNC_PENDING	La operación asincrónica todavía se está ejecutando.

Se pueden devolver valores devueltos adicionales, pero dependen de los códigos de retorno del método que devolvieron inicialmente el objeto IVssAsync .

[out] pReserved

El valor de este parámetro debe ser NULL.

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Value	Significado
S_OK	La operación de consulta se realizó correctamente.
E_ACCESSDENIED	Error en la operación de consulta porque el usuario no tenía los privilegios correctos.
E_INVALIDARG	El puntero a la variable usada para contener el valor devuelto pHrResult es NULL o no es una ubicación de memoria válida.
VSS_E_UNEXPECTED	error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, vea Control de eventos y errores en VSS. Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008 R2 y Windows 7. E_UNEXPECTED se usa en su lugar.

Comentarios

En caso de error durante el transcurso de una operación asincrónica, QueryStatus devolverá el mismo código de error que el método que devolvió inicialmente el objeto IVssAsync .

Para obtener una lista completa de los valores devueltos de un objeto IVssAsync::QueryStatus devuelto por un método específico, vea los códigos de error documentados para ese método.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vss.h
Library	VssApi.lib