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

Artigo
08/27/2023

O método QueryStatus consulta a status de uma operação assíncrona.

Sintaxe

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

Parâmetros

[out] pHrResult

O status da operação assíncrona que retornou o objeto IVssAsync atual.

Todas as chamadas para QueryStatus para todos os objetos IVssAsync dão suporte aos seguintes códigos status.

Valor	Significado
VSS_S_ASYNC_CANCELLED	A operação assíncrona foi cancelada por uma chamada anterior para IVssAsync::Cancel.
VSS_S_ASYNC_FINISHED	A operação assíncrona foi concluída com êxito.
VSS_S_ASYNC_PENDING	A operação assíncrona ainda está em execução.

Valores retornados adicionais podem ser retornados, mas dependem dos códigos de retorno do método que inicialmente retornou o objeto IVssAsync .

[out] pReserved

O valor desse parâmetro deve ser NULL.

Valor retornado

Veja a seguir os códigos de retorno válidos para esse método.

Valor	Significado
S_OK	A operação de consulta foi bem-sucedida.
E_ACCESSDENIED	A operação de consulta falhou porque o usuário não tinha os privilégios corretos.
E_INVALIDARG	O ponteiro para a variável usada para manter o valor retornado pHrResult é NULL ou não é um local de memória válido.
VSS_E_UNEXPECTED	Erro inesperado. O código de erro é registrado no arquivo de log de erros. Para obter mais informações, consulte Tratamento de eventos e erros em VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows Server 2008 R2 e o Windows 7. E_UNEXPECTED é usado.

Comentários

No caso de um erro durante o curso de uma operação assíncrona, QueryStatus retornará o mesmo código de erro que o método que inicialmente retornou o objeto IVssAsync .

Para obter uma lista completa de valores retornados para um objeto IVssAsync::QueryStatus retornado por um método específico, consulte os códigos de erro documentados para esse método.

Requisitos


Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	vss.h
Biblioteca	VssApi.lib