Функция SetupBackupErrorW (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. 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-terminated, указывающую заголовок диалогового окна ошибки. Если этот параметр null, используется название по умолчанию "Ошибка резервного копирования" (локализованная).
[in] SourceFile
Указатель на строку null-terminated, указывающую полный путь к исходному файлу, который выполняется резервное копирование.
[in] TargetFile
Необязательный указатель на строку null-terminated, указывающую полный путь к имени резервной копии файла. Этот параметр может быть NULL.
[out] Win32ErrorCode
Если возникает ошибка, этот элемент является системным кодом ошибки. Если ошибка не произошла, это NO_ERROR.
[in] Style
Флаги, управляющие форматированием и поведением диалогового окна. Этот параметр может быть одним из следующих флагов.
IDF_NOBEEP
Не допустить, чтобы диалоговое окно отображалось, чтобы получить внимание пользователя при первом появлении.
IDF_NOFOREGROUND
Запретить диалоговому окну стать окном переднего плана.
Возвращаемое значение
Эта функция возвращает одно из следующих значений.
Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Заметка
Заголовок setupapi.h определяет SetupBackupError как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows XP [только классические приложения] |
| минимальный поддерживаемый сервер | Windows Server 2003 [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | setupapi.h |
| библиотеки |
Setupapi.lib |
| DLL | Setupapi.dll |
См. также
Обзор