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

Статья
11/20/2024

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

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

Синтаксис

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

Параметры

[in] hwndParent

Обработайте родительское окно для этого диалогового окна.

[in] DialogTitle

Указатель на строку null-terminated, указывающую заголовок диалогового окна ошибки. Этот параметр может быть null. Если этот параметр null, используется заголовок по умолчанию "Переименовать ошибку" (локализованный).

[in] SourceFile

Указатель на строку null-terminated, которая указывает полный путь к исходному файлу, в котором произошел сбой операции.

[in] TargetFile

Указатель на строку null-terminated, указывающую полный путь к целевому файлу, в котором произошел сбой операции.

[in] Win32ErrorCode

Код системной ошибки обнаружен во время операции файла.

[in] Style

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

IDF_NOBEEP

При первом появлении диалогового окна запретить оповещение.

IDF_NOFOREGROUND

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

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

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

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

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	setupapi.h
библиотеки	Setupapi.lib
DLL	Setupapi.dll