Функция SetupBackupErrorW (setupapi.h)

Статья
08/26/2023

[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]

Функция SetupBackupError создает диалоговое окно, информирующее пользователя об ошибке резервного копирования.

Синтаксис

WINSETUPAPI UINT SetupBackupErrorW(
  [in]  HWND   hwndParent,
  [in]  PCWSTR DialogTitle,
  [in]  PCWSTR SourceFile,
  [in]  PCWSTR TargetFile,
  [out] UINT   Win32ErrorCode,
  [in]  DWORD  Style
);

Параметры

[in] hwndParent

Дескриптор родительского окна для этого диалогового окна.

[in] DialogTitle

Необязательный указатель на строку, завершающуюся значением NULL, указывающую заголовок диалогового окна ошибки. Если этот параметр имеет значение NULL, используется название по умолчанию "Ошибка резервного копирования" (локализованная).

[in] SourceFile

Указатель на строку, завершающуюся значением NULL, указывающую полный путь к исходному файлу, для которой выполняется резервное копирование.

[in] TargetFile

Необязательный указатель на строку со значением NULL, указывающую полный путь к имени резервной копии файла. Этот параметр может принимать значение NULL.

[out] Win32ErrorCode

При возникновении ошибки этот элемент является кодом системной ошибки. Если ошибка не произошла, она NO_ERROR.

[in] Style

Флаги, управляющие отображением форматирования и поведения диалогового окна. Этот параметр может быть одним из следующих флагов.

IDF_NOBEEP

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

IDF_NOFOREGROUND

Запретить этому диалоговому окну стать окном переднего плана.

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

Эта функция возвращает одно из следующих значений.

Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Заголовок setupapi.h определяет SetupBackupError в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	setupapi.h
Библиотека	Setupapi.lib
DLL	Setupapi.dll