IVssBackupComponents::AddToSnapshotSet-Methode (vsbackup.h)
Die AddToSnapshotSet-Methode fügt dem Schattenkopiersatz ein originales Volume oder eine ursprüngliche Remotedateifreigabe hinzu.
Syntax
HRESULT AddToSnapshotSet(
[in] VSS_PWSZ pwszVolumeName,
[in] VSS_ID ProviderId,
[out] VSS_ID *pidSnapshot
);
Parameter
[in] pwszVolumeName
Zeichenfolge mit Null-Endung, die den Namen des Volumes oder den UNC-Pfad der zu kopierenden Remotedateifreigabe enthält. Der Name oder UNC-Pfad 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)
- Ein UNC-Pfad, der eine Remotedateifreigabe angibt, z. B. \\Clusterx\Share1\
[in] ProviderId
Der zu verwendende Anbieter. GUID_NULL kann verwendet werden. In diesem Fall wird der Standardanbieter verwendet.
[out] pidSnapshot
Zurückgegebener Bezeichner der hinzugefügten Schattenkopie.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Das Volume oder die Remotedateifreigabe wurde dem Schattenkopiersatz erfolgreich hinzugefügt. |
|
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen. |
|
Die maximale Anzahl von Volumes oder Remotedateifreigaben wurde dem Schattenkopiersatz hinzugefügt. Das angegebene Volume oder die Remotedateifreigabe wurde dem Schattenkopiersatz nicht hinzugefügt. |
|
Das Volume oder die Remotedateifreigabe wurde der maximalen Anzahl von Schattenkopiersätzen hinzugefügt. Das angegebene Volume oder die Remotedateifreigabe wurde dem Schattenkopiersatz nicht hinzugefügt. |
|
Das angegebene Volume ist zu tief geschachtelt, um am VSS-Vorgang teilzunehmen. Mögliche Gründe für diesen Fehler sind:
|
|
pwszVolumeName entspricht keiner vorhandenen Volume- oder Remotedateifreigabe. |
|
ProviderId entspricht keinem registrierten Anbieter. |
|
Erwarteter Anbieterfehler. Der Anbieter hat den Fehler im Ereignisprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
Eine weitere Schattenkopie wird bereits erstellt. Tritt auf, wenn ein CSV-Volume zu einer Momentaufnahme-Gruppe von mehreren Knoten gleichzeitig hinzugefügt wird oder beim gleichzeitigen Hinzufügen einer Freigabe für horizontales Hochskalieren zur Momentaufnahme-Gruppe von mehreren SMB-Clientknoten aus. |
|
Der Wert des ProviderId-Parameters ist GUID_NULL, und kein VSS-Anbieter gibt an, dass er das angegebene Volume oder die angegebene Remotedateifreigabe unterstützt. |
|
Das Volume oder die Remotedateifreigabe wird vom angegebenen Anbieter nicht unterstützt. |
|
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. |
|
Der Anbieter hat einen unerwarteten Fehlercode zurückgegeben. Dieser Fehlercode wird nur über die QueryStatus-Methode auf der IVssAsync-Schnittstelle zurückgegeben, die im ppAsync-Parameter zurückgegeben wird. |
Hinweise
Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP und Windows Server 2003: Remotedateifreigaben werden erst unterstützt, wenn Windows 8 und Windows Server 2012.
Wenn pwszVolumeName ein UNC-Freigabepfad ist, muss der Servername im Hostnamen- oder vollqualifizierten Domänennamenformat vorliegen. UNC-Freigabenamen mit IP-Adressen müssen normalisiert werden, indem die IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths-Methode aufgerufen wird, bevor sie an AddToSnapshotSet übergeben werden.
Maximal können von 64 Volumes Schattenkopien in einem einzigen Schattenkopiesatz erstellt werden.
Wenn ProviderId GUID_NULL ist, wird der Standardanbieter gemäß dem folgenden Algorithmus ausgewählt:
- Wenn ein Hardwareanbieter das angegebene Volume oder die Remotedateifreigabe unterstützt, wird dieser Anbieter ausgewählt.
- Wenn kein Hardwareanbieter verfügbar ist und ein Softwareanbieter das angegebene Volume unterstützt, wird er ausgewählt.
- Wenn kein Hardwareanbieter oder Softwareanbieter verfügbar ist, wird der Systemanbieter ausgewählt. (Es gibt nur einen vorinstallierten Systemanbieter, der alle nicht übertragbaren lokalen Volumes unterstützen muss.)
Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: VHDs werden nicht unterstützt.
Der Schattenkopiebezeichner, der im pidSnapshot-Parameter zurückgegeben wird, wird im Dokument Sicherungskomponenten gespeichert. Es gibt jedoch keine Methode zum Abfragen dieser Informationen, und der Aufrufer muss sie möglicherweise speichern, damit sie während der Wiederherstellung verwendet werden kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |