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 anrufer zugewiesenen VSS_SNAPSHOT_PROP Struktur, die die Schattenkopieeigenschaften empfängt. Der Softwareanbieter ist für die Einstellung der Mitglieder dieser Struktur verantwortlich. Der Softwareanbieter weist Speicher für alle Zeichenfolgenelemente zu, die er in der Struktur festlegt. Wenn die Struktur nicht mehr benötigt wird, ist der Softwareanbieter dafür verantwortlich, diese Zeichenfolgen freizulegen, indem die VssFreeSnapshotProperties-Funktion aufgerufen wird.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Die Schattenkopieeigenschaften wurden erfolgreich zurückgegeben. |
|
Der Anrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator. |
|
Eine der Parameterwerte ist ungültig. |
|
Der Anrufer ist nicht im Arbeitsspeicher oder in anderen Systemressourcen vorhanden. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen. |
|
Die angegebene Schattenkopie ist nicht vorhanden. |
|
Erwarteter Anbieterfehler. Der Anbieter protokolliert den Fehler im Ereignisprotokoll. Weitere Informationen finden Sie unter "Ereignis- und Fehlerbehandlung unter VSS". |
|
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 unterstützt, wenn Windows Server 2008 R2 und Windows 7. E_UNEXPECTED wird stattdessen verwendet. |
|
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 verantwortlich für die Zuweisung und Freisetzung der Zeichenfolgen in der VSS_SNAPSHOT_PROP Struktur.
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::AddToSnapshotSet