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


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

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

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

Синтаксис

WINSETUPAPI PVOID SetupInitDefaultQueueCallback(
  [in] HWND OwnerWindow
);

Параметры

[in] OwnerWindow

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

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

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

Если вызов SetupInitDefaultQueueCallback завершается сбоем, функция возвращает значение PVOID со значением NULL.

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

Комментарии

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

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header setupapi.h
Библиотека Setupapi.lib
DLL Setupapi.dll

См. также

Функции

Обзор

SetupDefaultQueueCallback

SetupInitDefaultQueueCallbackEx