CVssWriter::GetSnapshotDeviceName-Methode (vswriter.h)

Artikel
03/06/2024

Die GetSnapshotDeviceName-Methode gibt den Namen des Geräts zurück, das die Schattenkopie des angegebenen Volumes oder der angegebenen Dateifreigabe hostet. Diese Methode ermöglicht es Autoren, Schattenkopien automatisch wiederherzustellen , und kann nur während der Verarbeitung der OnPostSnapshot-Methode aufgerufen werden.

Syntax

HRESULT GetSnapshotDeviceName(
  [in]  LPCWSTR wszOriginalVolume,
  [out] LPCWSTR *ppwszSnapshotDevice
);

Parameter

[in] wszOriginalVolume

Name des ursprünglichen Volumes oder des UNC-Pfads der ursprünglichen Dateifreigabe, die Daten enthält, die für den aktuellen Schattenkopiersatz verwendet werden. Der Name des Volumes 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 der Form \\?\Volume{GUID}\ (wobei GUID das Volume identifiziert)
Ein UNC-Pfad, der eine Remotedateifreigabe angibt, z. B. \\Clusterx\Share1\

[out] ppwszSnapshotDevice

Die Adresse eines LPCWSTR , der einen Zeiger auf den Gerätenamen der Schattenkopie erhält.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Der Name des Schattenkopievolumes wurde erfolgreich zurückgegeben.
E_INVALIDARG	Einer der Parameterwerte ist ungültig.
VSS_E_BAD_STATE	Der Aufruf wurde während des PostSnapshot-Ereignisses nicht getätigt.
VSS_E_OBJECT_NOT_FOUND	Der wszOriginalVolume-Parameter gehört nicht zu den Volumes oder Dateifreigaben im Schattenkopiersatz.

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.

Um den Namen des ursprünglichen Volumes für den wszOriginalVolume-Parameter abzurufen, rufen Sie zuerst die CVssWriter::GetCurrentVolumeCount-Methode auf, um die Anzahl der Volumes im Schattenkopiersatz abzufragen. Rufen Sie dann die CVssWriter::GetCurrentVolumeArray-Methode auf, um die ursprünglichen Namen der Volumes im Schattenkopiersatz aufzulisten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008, Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vswriter.h (einschließlich Vss.h, VsWriter.h)
Bibliothek	VssApi.lib

Freigeben über