IVssBackupComponents::GetSnapshotProperties-Methode (vsbackup.h)

Die GetSnapshotProperties-Methode ruft die Eigenschaften der angegebenen Schattenkopie ab.

Syntax

HRESULT GetSnapshotProperties(
  [in]  VSS_ID            SnapshotId,
  [out] VSS_SNAPSHOT_PROP *pProp
);

Parameter

[in] SnapshotId

Der Bezeichner der Schattenkopie eines Volumes, wie von IVssBackupComponents::AddToSnapshotSet zurückgegeben.

[out] pProp

Die Adresse einer aufruferseitig zugewiesenen VSS_SNAPSHOT_PROP Struktur, die die Schattenkopie-Eigenschaften empfängt. Der Softwareanbieter ist für das Festlegen der Member dieser Struktur verantwortlich. Der Softwareanbieter ordnet Arbeitsspeicher für alle Zeichenfolgenmember zu, die er in der -Struktur festlegt. Wenn die Struktur nicht mehr benötigt wird, ist der Softwareanbieter dafür verantwortlich, diese Zeichenfolgen durch Aufrufen der VssFreeSnapshotProperties-Funktion frei zu geben.

Rückgabewert

Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.

Wert Bedeutung
S_OK
Die Schattenkopieeigenschaften wurden erfolgreich zurückgegeben.
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 über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen.
VSS_E_OBJECT_NOT_FOUND
Die angegebene Schattenkopie ist nicht vorhanden.
VSS_E_PROVIDER_VETO
Erwarteter Anbieterfehler. Der Anbieter hat den Fehler im Ereignisprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
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.

VSS_E_UNEXPECTED_PROVIDER_ERROR
Unerwarteter Anbieterfehler. Der Fehlercode wird im Fehlerprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.

Hinweise

Der Aufrufer sollte den Inhalt der VSS_SNAPSHOT_PROP-Struktur auf Null festlegen, bevor die GetSnapshotProperties-Methode aufgerufen wird .

Der Anbieter ist für die Zuweisung und Freigabe der Zeichenfolgen in der VSS_SNAPSHOT_PROP-Struktur verantwortlich.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

IVssBackupComponents

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponents::StartSnapshotSet

VSS_ID

VSS_SNAPSHOT_PROP

VssFreeSnapshotProperties