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

Статья
08/26/2023

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

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

Синтаксис

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

Параметры

[in] hwndParent

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

[in] DialogTitle

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

[in] SourceFile

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

[in] TargetFile

Необязательный указатель на строку с пустым завершением, указывающую полный путь к имени резервной копии файла. Этот параметр может принимать значение 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