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

Статья
11/20/2024

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

Функция setupDefaultQueueCallback по умолчанию — это подпрограмма обратного вызова очереди по умолчанию, включенная в API установки. Его можно использовать для обработки уведомлений, отправленных функцией SetupCommitFileQueue.

Синтаксис

WINSETUPAPI UINT SetupDefaultQueueCallbackA(
  [in] PVOID    Context,
  [in] UINT     Notification,
  [in] UINT_PTR Param1,
  [in] UINT_PTR Param2
);

Параметры

[in] Context

Указатель на контекст, инициализированный функциям и setupInitDefaultQueueCallback или SetupInitDefaultQueueCallbackEx.

[in] Notification

Уведомление о действии очереди. Этот параметр может быть одним из значений, показанных в следующей таблице.

Ценность	Значение
SPFILENOTIFY_STARTQUEUE	Запущены операции с файлами в очереди.
SPFILENOTIFY_ENDQUEUE	Завершенные операции с файлами в очереди.
SPFILENOTIFY_STARTSUBQUEUE	Запуск подзапуска копирования, переименования или удаления.
SPFILENOTIFY_ENDSUBQUEUE	Завершено копирование, переименование или удаление вложенных запросов.
SPFILENOTIFY_STARTRENAME	Запустил операцию переименования.
SPFILENOTIFY_ENDRENAME	Завершена операция переименования.
SPFILENOTIFY_RENAMEERROR	Произошла ошибка при переименовании файла.
SPFILENOTIFY_STARTDELETE	Запустил операцию удаления.
SPFILENOTIFY_ENDDELETE	Завершена операция удаления.
SPFILENOTIFY_DELETEERROR	Произошла ошибка при удалении файла.
SPFILENOTIFY_STARTCOPY	Запущена операция копирования.
SPFILENOTIFY_ENDCOPY	Завершена операция копирования.
SPFILENOTIFY_COPYERROR	Произошла ошибка при копировании файла.
SPFILENOTIFY_NEEDMEDIA	Требуется новый носитель.
SPFILENOTIFY_LANGMISMATCH	Существующий целевой файл находится на языке, отличном от исходного.
SPFILENOTIFY_TARGETEXISTS	Целевой файл существует.
SPFILENOTIFY_TARGETNEWER	Существующий целевой файл является более новым, чем исходный.

[in] Param1

Дополнительные сведения о сообщении. Содержимое этого параметра зависит от значения параметра Notification.

[in] Param2

Дополнительные сведения о сообщении. Содержимое этого параметра зависит от значения параметра Notification.

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

Возвращает целое число без знака для SetupCommitFileQueue, которое может быть одним из значений, показанных в следующей таблице.

Возвращаемый код	Описание
FILEOP_ABORT	Прерывает операцию.
FILEOP_DOIT	Выполняет операцию файла.
FILEOP_SKIP	Пропускает операцию.
FILEOP_RETRY	Повторите операцию.
FILEOP_NEWPATH	Возвращает новый путь для операции.

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

Замечания

Функция setupDefaultQueueCallback обычно вызывается явным образом с помощью пользовательской процедуры обратного вызова очереди. Настраиваемый обратный вызов обрабатывает подмножество уведомлений о фиксации очереди и вызывает функцию SetupDefaultQueueCallback для обработки остальных уведомлений.

Дополнительные сведения см. в уведомления о очереди.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	setupapi.h
библиотеки	Setupapi.lib
DLL	Setupapi.dll
набор API	ext-ms-win-setupapi-classinstallers-l1-1-2 (представлено в Windows 10 версии 10.0.14393)

См. также

Функции

Обзор

SetupCommitFileQueue

Поделиться через