Метод IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths (vsbackup.h)

  • Статья

Нормализует путь локального тома или UNC-путь к общей папке, чтобы его можно было передать в метод IVssBackupComponents::AddToSnapshotSet .

Синтаксис

HRESULT GetRootAndLogicalPrefixPaths(
  [in]           VSS_PWSZ pwszFilePath,
  [out]          VSS_PWSZ *ppwszRootPath,
  [out]          VSS_PWSZ *ppwszLogicalPrefix,
  [in, optional] BOOL     bNormalizeFQDNforRootPath
);

Параметры

[in] pwszFilePath

Путь для нормализации.

[out] ppwszRootPath

Получает корневой путь, который должен быть передан методу IVssBackupComponents::AddToSnapshotSet .

[out] ppwszLogicalPrefix

Если pwszFilePath является локальным путем, этот параметр получает имя GUID тома. Если это UNC-путь, этот параметр получает полностью вычисляемый путь к общей папке.

[in, optional] bNormalizeFQDNforRootPath

Если pwszFilePath является UNC-путем к общей папке, частью имени сервера может быть

  • Имя узла
  • Полное доменное имя
  • IP-адрес

Этот параметр указывает, следует ли использовать формат имени узла или полный формат доменного имени в части имени сервера нормализованного корневого пути, возвращаемого в параметре ppwszRootPath .

Если этот параметр имеет значение FALSE, будет использоваться простой формат имени узла.

Значение по умолчанию для этого параметра — FALSE.

Если этот параметр имеет значение TRUE, будет использоваться полное доменное имя.

В развертывании, где имя узла может существовать в нескольких суффиксах домена, этот параметр должен иметь значение TRUE.

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

Ниже приведены допустимые коды возврата для этого метода.

Код возврата Описание
S_OK
 Сведения о пути успешно возвращены.
E_OUTOFMEMORY
 Вызывающий объект не имеет памяти или других системных ресурсов.

Комментарии

Этот метод нормализует путь локального тома или UNC-путь к общей папке и разделяет его на корневой путь и путь логического префикса. Затем корневой путь можно передать в метод IVssBackupComponents::AddToSnapshotSet .

Если pwszFilePath является локальным путем к тому, корневой путь будет похож на точку подключения тома. В этом случае корневой и логический префикс пути сопоставляется с результатами GetVolumePathName и GetVolumeNameForVolumeMountPoint соответственно.

Если pwszFilePath — это путь к общей папке UNC, пути корневого и логического префикса сопоставляются с корневым путем к общей папке и полностью вычисляемому пути к физическому ресурсу (который будет учитывать развертывание DFS и кластера) соответственно.

Если этот метод вызывается несколько раз для одной и той же операции создания набора теневого копирования, необходимо задать для параметра bNormalizeFQDNforRootPath одинаковое значение для каждого вызова. Полный формат доменного имени и формат имени узла не могут быть смешаны в одном наборе теневого копирования.

Требования

   
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header vsbackup.h (включая VsBackup.h, Vss.h, VsWriter.h)

См. также раздел

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponentsEx4