IVssBackupComponents::ExposeSnapshot-Methode (vsbackup.h)
Die ExposeSnapshot-Methode macht eine Schattenkopie als Laufwerkbuchstaben, eingebundenen Ordner oder Dateifreigabe verfügbar.
Syntax
HRESULT ExposeSnapshot(
[in] VSS_ID SnapshotId,
[in] VSS_PWSZ wszPathFromRoot,
[in] LONG lAttributes,
[in] VSS_PWSZ wszExpose,
[out] VSS_PWSZ *pwszExposed
);
Parameter
[in] SnapshotId
Bezeichner für Schattenkopien.
[in] wszPathFromRoot
Der Pfad zu dem Teil des Volumes, der beim Verfügbarmachen einer Schattenkopie als Dateifreigabe zur Verfügung gestellt wird. Der Wert dieses Parameters muss NULL sein, wenn eine Schattenkopie lokal verfügbar gemacht wird. d. h. als Laufwerkbuchstabe oder eingebundener Ordner verfügbar machen.
Der Pfad darf keine Umgebungsvariablen (z. B. %MyEnv%) oder Feldhalterzeichen enthalten.
Es ist nicht erforderlich, dass der Pfad mit einem umgekehrten Schrägstrich ("") endet. Anwendungen, die diese Informationen abrufen, müssen überprüft werden.
[in] lAttributes
Attribute der verfügbar gemachten Schattenkopie, die angeben, ob sie lokal oder remote verfügbar gemacht wird. Der Wert muss entweder der VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY oder der VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY Wert von _VSS_VOLUME_SNAPSHOT_ATTRIBUTES sein.
[in] wszExpose
Wenn eine Schattenkopie als Dateifreigabe verfügbar gemacht wird, ist der Wert dieses Parameters der Freigabename. Wenn eine Schattenkopie durch Einbinden als Gerät verfügbar gemacht wird, ist der Parameterwert ein Laufwerkbuchstabe gefolgt von einem Doppelpunkt, z. B. "X:" oder ein eingebundener Ordnerpfad (z. B. "Y:\MountX"). Wenn der Wert dieses Parameters NULL ist, bestimmt VSS den Freigabenamen oder laufwerksbuchstaben, wenn der lAttributes-ParameterVSS_VOLSNAP_ATTR_EXPOSED_REMOTELY ist.
[out] pwszExposed
Der offengelegte Name der Schattenkopie. Dies ist entweder ein Freigabename, ein Laufwerkbuchstabe gefolgt von einem Doppelpunkt oder ein eingebundener Ordner. Der Wert ist NULL , wenn ExposeSnapshot fehlgeschlagen ist. VSS weist den Arbeitsspeicher für diese Zeichenfolge zu.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Die Schattenkopien wurden erfolgreich verfügbar gemacht. |
|
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht in der richtigen Sequenz aufgerufen. |
|
Die angegebene Schattenkopie ist nicht vorhanden. |
|
Erwarteter Anbieterfehler. Der Anbieter hat den Fehler im Ereignisprotokoll protokolliert. 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 unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet. |
|
Unerwarteter Anbieterfehler. Der Fehlercode wird im Fehlerprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
Hinweise
Der Aufrufer ist für das Freigeben der Zeichenfolge verantwortlich, auf die der pwszExposed-Parameter verweist, indem er die CoTaskMemFree-Funktion aufruft.
Beim Offenlegen einer dauerhaften Schattenkopie bleibt sie durch nachfolgende Neustarts verfügbar.
Wenn sie eine Schattenkopie eines Volumes verfügbar macht, kann die Schattenkopie entweder als eingebundenes Gerät oder als Dateisystem behandelt werden, das für die Dateifreigabe verfügbar ist.
Wenn es wie bei anderen eingebundenen Geräten als Gerät verfügbar gemacht wird, wird die Schattenkopie eines Volumes am Bereitstellungspunkt (Laufwerkbuchstabe oder eingebundener Ordner) ab dem Stamm verfügbar gemacht.
Wenn sie als Dateifreigabe verfügbar gemacht werden, können Teilmengen (angegeben durch wszPathFromRoot) des Volumes freigegeben werden.
Weitere Informationen zum Verfügbarmachen von Schattenkopien finden Sie unter Verfügbarmachen und Überdecken von kopierten Schattenvolumes.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (einschließlich VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |
Weitere Informationen
IVssBackupComponents::ImportSnapshots