IVssBackupComponents::GetSnapshotProperties-Methode (vsbackup.h)

Artikel
08/27/2023

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