Метод IVssBackupComponents::AddToSnapshotSet (vsbackup.h)
Метод AddToSnapshotSet добавляет исходный том или исходный удаленный файловый ресурс в набор теневого копирования.
Синтаксис
HRESULT AddToSnapshotSet(
[in] VSS_PWSZ pwszVolumeName,
[in] VSS_ID ProviderId,
[out] VSS_ID *pidSnapshot
);
Параметры
[in] pwszVolumeName
Строка расширенных символов со значением NULL, содержащая имя тома или UNC-путь к удаленной общей папке для теневого копирования. Имя или UNC-путь должны иметь один из следующих форматов и включать обратную косую черту в конце (\):
- Путь к подключенной папке, например Y:\MountX\
- Буква диска, например D:\
- Путь GUID тома в формате \\?\Volume{GUID}\ (где GUID идентифицирует том)
- UNC-путь, указывающий удаленный файловый ресурс, например \\Clusterx\Share1\
[in] ProviderId
Используемый поставщик. GUID_NULL можно использовать, в этом случае будет использоваться поставщик по умолчанию.
[out] pidSnapshot
Возвращен идентификатор добавленной теневой копии.
Возвращаемое значение
Ниже приведены допустимые коды возврата для этого метода.
| Значение | Значение |
|---|---|
|
В набор теневого копирования успешно добавлен том или удаленный файловый ресурс. |
|
Вызывающий объект не имеет достаточных прав на резервное копирование или не является администратором. |
|
Одно из значений параметра является недопустимым. |
|
Вызывающий объект не имеет памяти или других системных ресурсов. |
|
Объект компонента резервной копии не инициализирован, этот метод был вызван во время операции восстановления или этот метод не был вызван в правильной последовательности. |
|
В набор теневого копирования добавлено максимальное количество томов или удаленных общих папок. Указанный том или удаленный файловый ресурс не были добавлены в набор теневого копирования. |
|
Том или удаленный файловый ресурс был добавлен к максимальному количеству наборов теневых копий. Указанный том или удаленный файловый ресурс не были добавлены в набор теневого копирования. |
|
Указанный том слишком глубоко вложен для участия в операции VSS. Возможные причины этой ошибки:
|
|
pwszVolumeName не соответствует существующему тому или удаленной общей папке. |
|
ProviderId не соответствует зарегистрированному поставщику. |
|
Ожидаемая ошибка поставщика. Поставщик зарегистрировал ошибку в журнале событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. |
|
Еще одно создание теневой копии уже выполняется. Происходит при добавлении тома CSV в набор snapshot из нескольких узлов одновременно или при добавлении масштабируемого общего ресурса в snapshot набор из нескольких клиентских узлов SMB одновременно. |
|
Значение параметра ProviderId равно GUID_NULL, и ни поставщик VSS не указывает, что он поддерживает указанный том или удаленный файловый ресурс. |
|
Указанный поставщик не поддерживает том или удаленную общую папку. |
|
Непредвиденная ошибка. Код ошибки регистрируется в файле журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED. |
|
Поставщик вернул непредвиденный код ошибки. Этот код ошибки возвращается только с помощью метода QueryStatus в интерфейсе IVssAsync , возвращенном в параметре ppAsync . |
Комментарии
Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP и Windows Server 2003: Удаленные общие папки не поддерживаются до Windows 8 и Windows Server 2012.
Если pwszVolumeName является UNC-путем к общей папке, часть имени сервера должна быть в формате имени узла или полного доменного имени. Имена общих ресурсов UNC с IP-адресами должны быть нормализованы путем вызова метода IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths перед их передачей в AddToSnapshotSet.
Максимальное число теневых копий томов в одном наборе теневых копий — 64.
Если значение ProviderId равно GUID_NULL, поставщик по умолчанию выбирается в соответствии со следующим алгоритмом:
- Если какой-либо поставщик оборудования поддерживает данный том или удаленный файловый ресурс, выбирается этот поставщик.
- Если поставщик оборудования отсутствует, если какой-либо поставщик программного обеспечения поддерживает данный том, он выбирается.
- Если поставщик оборудования или программного обеспечения отсутствует, выбирается поставщик системы. (Существует только один предустановленный системный поставщик, который должен поддерживать все неустранимые локальные тома.)
Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Виртуальные жесткие диски не поддерживаются.
Идентификатор теневого копирования, возвращаемый в параметре pidSnapshot , хранится в документе Компонентов резервного копирования. Однако нет метода для запроса этих сведений, и вызывающему объекту может потребоваться сохранить их, чтобы их можно было использовать во время восстановления.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vsbackup.h (включая VsBackup.h, Vss.h, VsWriter.h) |
| Библиотека | VssApi.lib |
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по