Метод IVssComponentEx::GetRestoreName (vswriter.h)

Получает логическое имя, назначенное восстанавливаемому компоненту.

Синтаксис

HRESULT GetRestoreName(
  [out] BSTR *pbstrName
);

Параметры

[out] pbstrName

Адрес переменной, выделенной вызывающим объектом, которая получает строку символов, завершающуюся null, содержащую имя восстановления компонента.

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

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

Значение	Значение
S_OK	Операция выполнена успешно.
E_INVALIDARG	Одно из значений параметра недопустимо.
E_OUTOFMEMORY	У вызывающего объекта не хватает памяти или других системных ресурсов.

Комментарии

Метод GetRestoreName можно вызвать только во время операции восстановления.

Если вызов GetRestoreName выполнен успешно, вызывающий объект отвечает за освобождение строки, возвращаемой в параметре pbstrName , путем вызова функции SysFreeString .

Модуль записи указывает, что он поддерживает этот метод, установив флаг VSS_BS_RESTORE_RENAME в маске резервной схемы.

Дополнительные сведения см. в разделе Настройка параметров восстановления VSS.

Требования

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

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

IVssBackupComponentsEx2::SetRestoreName

IVssComponentEx

VSS_BACKUP_SCHEMA