IVssSoftwareSnapshotProvider::QueryRevertStatus-Methode (vsprov.h)

  • Artikel

Gibt einen IVssAsync-Schnittstellenzeiger zurück, mit dem die status des rückgängig machen-Vorgangs bestimmt werden kann.

Syntax

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

Parameter

[in] pwszVolume

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

  • Der Pfad eines eingebundenen Ordners, z. B. Y:\MountX\
  • Ein Laufwerkbuchstabe, z. B. D:\
  • Ein Volume-GUID-Pfad der Form \\?\Volume{GUID}\ (wobei GUID das Volume identifiziert)

[out] ppAsync

Zeiger auf einen Speicherort, der einen IVssAsync-Schnittstellenzeiger empfängt, mit dem die status des rückgängig machen-Vorgangs abgerufen werden kann. Wenn der Vorgang abgeschlossen ist, muss der Aufrufer den Schnittstellenzeiger freigeben, indem er die IUnknown::Release-Methode aufruft.

Rückgabewert

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

Wert Bedeutung
S_OK
 Die status des rückgängig machen Vorgangs 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 verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_OBJECT_NOT_FOUND
 Der parameter pwszVolume gibt kein gültiges Volume an.
VSS_E_VOLUME_NOT_SUPPORTED
 Der rückgängig machen-Vorgang wird auf diesem Volume nicht unterstützt.

Hinweise

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vsprov.h
Bibliothek VssApi.lib

Weitere Informationen

IVssSoftwareSnapshotProvider