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
S_OK	Die Schattenkopien wurden erfolgreich verfügbar gemacht.
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 nicht über 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 in 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 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

IVssBackupComponents::ImportSnapshots

IVssBackupComponentsEx2::UnexposeSnapshot

VSS_PWSZ

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES