IVssAsync::QueryStatus-Methode (vss.h)
Die QueryStatus-Methode fragt die status eines asynchronen Vorgangs ab.
Syntax
HRESULT QueryStatus(
[out] HRESULT *pHrResult,
[out] INT *pReserved
);
Parameter
[out] pHrResult
Die status des asynchronen Vorgangs, der das aktuelle IVssAsync-Objekt zurückgegeben hat.
Alle Aufrufe von QueryStatus für alle IVssAsync-Objekte unterstützen die folgenden status-Codes.
Wert | Bedeutung |
---|---|
|
Der asynchrone Vorgang wurde durch einen vorherigen Aufruf von IVssAsync::Cancel abgebrochen. |
|
Der asynchrone Vorgang wurde erfolgreich abgeschlossen. |
|
Der asynchrone Vorgang wird weiterhin ausgeführt. |
Zusätzliche Rückgabewerte können zurückgegeben werden, hängen jedoch von den Rückgabecodes der Methode ab, die das IVssAsync-Objekt ursprünglich zurückgegeben hat.
[out] pReserved
Der Wert dieses Parameters sollte NULL sein.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
Wert | Bedeutung |
---|---|
|
Der Abfragevorgang war erfolgreich. |
|
Fehler beim Abfragevorgang, weil der Benutzer nicht über die richtigen Berechtigungen verfügte. |
|
Der Zeiger auf die Variable, die zum Halten des pHrResult-Rückgabewerts verwendet wird, ist NULL oder ist kein gültiger Speicherort. |
|
Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet. |
Hinweise
Im Fall eines Fehlers während eines asynchronen Vorgangs gibt QueryStatus denselben Fehlercode wie die Methode zurück, die ursprünglich das IVssAsync-Objekt zurückgegeben hat.
Eine vollständige Liste der Rückgabewerte für ein IVssAsync::QueryStatus-Objekt , das von einer bestimmten Methode zurückgegeben wird, finden Sie in den für diese Methode dokumentierten Fehlercodes.
Anforderungen
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | vss.h |
Bibliothek | VssApi.lib |
Weitere Informationen
IVssBackupComponents::D oSnapshotSet
IVssBackupComponents::GatherWriterMetadata
IVssBackupComponents::GatherWriterStatus
IVssBackupComponents::ImportSnapshots
IVssBackupComponents::P ostRestore