IVssDifferentialSoftwareSnapshotMgmt3::GetVolumeProtectLevel-Methode (vsmgmt.h)

Artikel
03/03/2024

Ruft die Schattenkopieschutzebene ab und status für das angegebene Volume.

Syntax

HRESULT GetVolumeProtectLevel(
  [in]  VSS_PWSZ                   pwszVolumeName,
  [out] VSS_VOLUME_PROTECTION_INFO *protectionLevel
);

Parameter

[in] pwszVolumeName

Der Name des Volumes. Dieser Parameter ist erforderlich und darf nicht NULL sein.

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 im Format \\?\Volume{GUID}\ (wobei GUID das Volume identifiziert)

[out] protectionLevel

Die Adresse eines vom Aufrufer zugewiesenen Puffers, der eine VSS_VOLUME_PROTECTION_INFO Struktur empfängt, die Informationen über die Schattenkopieschutzebene des Volumes enthält.

Rückgabewert

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

Wert	Bedeutung
S_OK	Die Schattenkopieschutzebene wurde erfolgreich abgefragt.
E_ACCESSDENIED 0x80070005L	Der Aufrufer ist kein Administrator.
E_INVALIDARG 0x80070057L	Einer der Parameterwerte ist ungültig.
E_NOTIMPL 0x800000001L	Der Anbieter für das Volume unterstützt keinen Schattenkopienschutz.
VSS_E_PROVIDER_VETO 0x80042306L	Ein erwarteter Anbieterfehler ist aufgetreten. Der Fehlercode wird im Ereignisprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
VSS_E_OBJECT_NOT_FOUND 0x80042308L	Das angegebene Volume wurde nicht gefunden.

Hinweise

Die GetVolumeProtectLevel-Methode ruft Informationen zur aktuellen Schutzebene des Volumes ab. Wenn sich das Volume in einem fehlerhaften Zustand befindet, enthält das m_protectionFault Member der VSS_VOLUME_PROTECTION_INFO-Struktur den aktuellen Schutzfehler, und der m_failureStatus Member enthält den Grund, warum sich das Volume in einem fehlerhaften Zustand befindet. Wenn sich das Volume nicht in einem fehlerhaften Zustand befindet, sind die m_protectionFault - und m_failureStatus-Member 0.

Wenn der Wert des protectionLevel-ParametersVSS_PROTECTION_LEVEL_SNAPSHOT ist, müssen die Anforderer mithilfe der IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea-Methode Schattenkopiespeicherbereichszuordnungen (diff Bereich) festlegen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vsmgmt.h

Weitere Informationen

IVssDifferentialSoftwareSnapshotMgmt3

IVssDifferentialSoftwareSnapshotMgmt3::SetVolumeProtectLevel

Freigeben über