ShouldBlockRevert-Funktion (vsbackup.h)

Artikel
08/27/2023

Überprüft die Registrierung auf Writer, die rückgängig machen Vorgänge auf dem angegebenen Volume blockieren sollen.

Hinweis Diese Funktion ist nur unter Windows Server-Betriebssystemen verfügbar.

Syntax

HRESULT ShouldBlockRevert(
  [in]  LPCWSTR wszVolumeName,
  [out] bool    *pbBlock
);

Parameter

[in] wszVolumeName

Der Name des Volumes. Dieser 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 im Format \\?\Volume{GUID}\ (wobei GUID das Volume identifiziert)

[out] pbBlock

Ein Zeiger auf eine Variable, die true empfängt, wenn das Volume Komponenten von Writern enthält, die in der Registrierung als Writer aufgeführt sind, die rückgängig machen Vorgänge blockieren sollen, oder andernfalls false.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Die Funktion wurde erfolgreich ausgeführt.
E_ACCESSDENIED	Der Aufrufer ist kein Administrator.
E_INVALIDARG	Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY	Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_UNEXPECTED	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

Die Liste der Writer, die rückgängig machen Vorgänge blockieren sollen, wird in der Registrierung unter dem folgenden Schlüssel gespeichert:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\VSS\Settings\WritersBlockingRevert

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008, Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h)
Bibliothek	VssApi.lib
DLL	VssApi.dll

Freigeben über