Metodo IVssAsync::QueryStatus (vss.h)

Articolo
08/27/2023

Il metodo QueryStatus esegue una query sullo stato di un'operazione asincrona.

Sintassi

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

Parametri

[out] pHrResult

Stato dell'operazione asincrona che ha restituito l'oggetto IVssAsync corrente.

Tutte le chiamate a QueryStatus per tutti gli oggetti IVssAsync supportano i codici di stato seguenti.

Valore	Significato
VSS_S_ASYNC_CANCELLED	L'operazione asincrona è stata annullata da una chiamata precedente a IVssAsync::Cancel.
VSS_S_ASYNC_FINISHED	L'operazione asincrona è stata completata correttamente.
VSS_S_ASYNC_PENDING	L'operazione asincrona è ancora in esecuzione.

I valori restituiti aggiuntivi possono essere restituiti, ma dipendono dai codici restituiti del metodo che inizialmente ha restituito l'oggetto IVssAsync .

[out] pReserved

Il valore di questo parametro deve essere NULL.

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore	Significato
S_OK	L'operazione di query ha avuto esito positivo.
E_ACCESSDENIED	L'operazione di query non è riuscita perché l'utente non ha avuto i privilegi corretti.
E_INVALIDARG	Il puntatore alla variabile usata per contenere il valore restituito pHrResult è NULL o non è una posizione di memoria valida.
VSS_E_UNEXPECTED	Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato.

Commenti

In caso di errore durante il corso di un'operazione asincrona, QueryStatus restituirà lo stesso codice di errore del metodo che inizialmente ha restituito l'oggetto IVssAsync .

Per ottenere un elenco completo di valori restituiti per un oggetto IVssAsync::QueryStatus restituito da un metodo specifico, vedere i codici di errore documentati per tale metodo.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vss.h
Libreria	VssApi.lib