Поделиться через

Метод CVssWriter::GetSnapshotDeviceName (vswriter.h)

  • Статья

Метод GetSnapshotDeviceName возвращает имя устройства, на котором размещена теневая копия указанного тома или общей папки. Этот метод позволяет модулям записи поддерживать теневые копии с автоматическим восстановлением и может вызываться только во время обработки метода OnPostSnapshot .

Синтаксис

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

Параметры

[in] wszOriginalVolume

Имя исходного тома или UNC-путь к исходной общей папке, содержащей данные, используемые для текущего набора теневых копий. Имя тома должно быть в одном из следующих форматов и должно содержать обратную косую черту в конце (\):

  • Путь к подключенной папке, например Y:\MountX\
  • Буква диска, например D:\
  • Путь GUID тома в формате \\?\Volume{GUID}\ (где GUID идентифицирует том)
  • UNC-путь, указывающий удаленный файловый ресурс, например \\Clusterx\Share1\

[out] ppwszSnapshotDevice

Адрес LPCWSTR , который получит указатель на имя устройства теневой копии.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Значение Значение
S_OK
 Имя тома теневого копирования успешно возвращено.
E_INVALIDARG
 Одно из значений параметра является недопустимым.
VSS_E_BAD_STATE
 Вызов не был выполнен во время события PostSnapshot.
VSS_E_OBJECT_NOT_FOUND
 Параметр wszOriginalVolume не является одним из томов или общих папок в наборе теневого копирования.

Комментарии

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP и Windows Server 2003: Удаленные общие папки не поддерживаются до Windows 8 и Windows Server 2012.

Чтобы получить имя исходного тома для параметра wszOriginalVolume , сначала вызовите метод CVssWriter::GetCurrentVolumeCount , чтобы запросить количество томов в наборе теневого копирования. Затем вызовите метод CVssWriter::GetCurrentVolumeArray , чтобы перечислить исходные имена томов в наборе теневого копирования.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008, Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения]
Целевая платформа Windows
Header vswriter.h (включая Vss.h, VsWriter.h)
Библиотека VssApi.lib