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

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

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

Синтаксис

WINSETUPAPI PVOID SetupInitDefaultQueueCallbackEx(
  [in] HWND  OwnerWindow,
  [in] HWND  AlternateProgressWindow,
  [in] UINT  ProgressMessage,
  [in] DWORD Reserved1,
  [in] PVOID Reserved2
);

Параметры

[in] OwnerWindow

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

[in] AlternateProgressWindow

Дескриптор в окно, которое получает сообщения о ходе выполнения. Чтобы предотвратить отображение сообщений о ходе выполнения, можно указать этот параметр для INVALID_HANDLE_VALUE.

[in] ProgressMessage

Сообщение, которое отправляется в AlternateProgressWindow при запуске очереди копирования и при каждом копировании файла.

[in] Reserved1

Первый параметр сообщения, отправляемый в AlternateProgressWindow подпрограммой обратного вызова по умолчанию.

[in] Reserved2

Второй параметр сообщения, который отправляется в AlternateProgressWindow подпрограммой обратного вызова по умолчанию.

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

SetupInitDefaultQueueCallbackEx возвращает указатель на контекст, используемый подпрограммой обратного вызова очереди по умолчанию. Эта функция может завершиться ошибкой, только если недостаточно памяти. Если эта функция завершается сбоем, она возвращает значение NULL и не задает код последней ошибки для потока.

Комментарии

Когда очередь начинает фиксировать вложенную очередь копирования, подпрограмма обратного вызова очереди по умолчанию отправляет сообщение в окно, указанное в AlternateProgressWindow. Reserved1 имеет значение 0, а Reserved2 — указатель на количество операций копирования файлов, помещенных в очередь.

Для каждой завершенной операции копирования файлов подпрограмма обратного вызова очереди по умолчанию отправляет сообщение в AlternateProgressWindow, которое можно использовать для "галочки" индикатора выполнения. Reserved1 имеет значение 1, а Reserved2 — ноль.

SetupInitDefaultQueueCallbackEx можно использовать для получения поведения по умолчанию для запроса диска, обработки ошибок и т. д., а также для предоставления датчика, внедренного в страницу мастера или другое специализированное диалоговое окно.

Независимо от того, инициализировали ли контекст, используемый подпрограммой обратного вызова очереди по умолчанию, с помощью SetupInitDefaultQueueCallbackback или SetupInitDefaultQueueCallbackEx, после завершения обработки операций в очереди вызовите Метод SetupTermDefaultQueueCallback , чтобы освободить ресурсы, выделенные при инициализации структуры контекста. Дополнительные сведения см. в разделе Инициализация и завершение контекста обратного вызова.

Требования

См. также

Функции

Обзор

SetupInitDefaultQueueCallback