Freigeben über

IVssDifferentialSoftwareSnapshotMgmt3::GetVolumeProtectLevel-Methode (vsmgmt.h)

  • Artikel

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