Функция SetupIterateCabinetA (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]
Функция SetupIterateCabinet выполняет итерацию по всем файлам в шкафу и отправляет уведомление функции обратного вызова для каждого найденного файла.
Синтаксис
WINSETUPAPI BOOL SetupIterateCabinetA(
[in] PCSTR CabinetFile,
[in] DWORD Reserved,
[in] PSP_FILE_CALLBACK_A MsgHandler,
[in] PVOID Context
);
Параметры
[in] CabinetFile
Cab -файл (.CAB) для итерации.
[in] Reserved
В настоящий момент не используется.
[in] MsgHandler
Указатель на подпрограмму FileCallback , которая будет обрабатывать уведомления, возвращаемые SetupIterateCabinet при итерациях по файлам в cab-файле. Затем подпрограмма обратного вызова может возвращать значение, указывающее, следует ли распаковывать, копировать или пропускать файл.
[in] Context
Значение контекста, передаваемое в подпрограмму, указанную в MsgHandler. Это позволяет подпрограмме обратного вызова отслеживать значения между уведомлениями без использования глобальных переменных.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет ненулевым.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Примечание
Заголовок setupapi.h определяет SetupIterateCabinet в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | setupapi.h |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |
| Набор API | ext-ms-win-setupapi-classinstallers-l1-1-2 (представлено в Windows 10 версии 10.0.14393) |