Freigeben über


IVssSoftwareSnapshotProvider::QueryRevertStatus-Methode (vsprov.h)

Gibt einen IVssAsync-Schnittstellenzeiger zurück, der verwendet werden kann, um den Status des Wiederherstellungsvorgangs zu bestimmen.

Syntax

HRESULT QueryRevertStatus(
  [in]  VSS_PWSZ  pwszVolume,
  [out] IVssAsync **ppAsync
);

Die Parameter

[in] pwszVolume

Breite Zeichenfolge mit Null-Beendigung, die den Volumenamen enthält. Der Name muss in einem der folgenden Formate vorliegen und einen nachfolgenden umgekehrten Schrägstrich (\) enthalten:

  • Der Pfad eines bereitgestellten Ordners, z. B. Y:\MountX\
  • Ein Laufwerkbuchstaben, z. B. D:\
  • Ein Volume-GUID-Pfad des Formulars \\?\Volume{GUID}\ (wobei GUID das Volume identifiziert)

[out] ppAsync

Zeiger auf eine Position, die einen IVssAsync-Schnittstellenzeiger empfängt, der verwendet werden kann, um den Status des Wiederherstellungsvorgangs abzurufen. Nach Abschluss des Vorgangs muss der Aufrufer den Schnittstellenzeiger freigeben, indem die IUnknown::Release-Methode aufgerufen wird.

Rückgabewert

Nachfolgend sind die gültigen Rückgabecodes für diese Methode aufgeführt.

Wert Bedeutung
S_OK
Der Status des Wiederherstellungsvorgangs wurde erfolgreich abgefragt.
E_ACCESSDENIED
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer ist nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_OBJECT_NOT_FOUND
Der Parameter pwszVolume gibt kein gültiges Volume an.
VSS_E_VOLUME_NOT_SUPPORTED
Der Wiederherstellungsvorgang wird auf diesem Volume nicht unterstützt.

Bemerkungen

Der Wiederherstellungsvorgang wird auch dann fortgesetzt, wenn der Computer neu gestartet wird und nicht abgebrochen oder rückgängig gemacht werden kann, außer durch Wiederherstellen einer Sicherung, die mit einer anderen Methode erstellt wurde. Die IVssAsync::QueryStatus-Methode kann VSS_S_ASYNC_CANCELLED nicht zurückgeben, da der Wiederherstellungsvorgang nach dem Start nicht abgebrochen werden kann.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2003 [Nur Desktop-Apps]
Zielplattform Fenster
Header vsprov.h
Library VssApi.lib

Siehe auch

IVssSoftwareSnapshotProvider