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

Статья
11/20/2024

[Эта функция доступна для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. 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) для итерации.

[in] Reserved

В настоящее время не используется.

[in] MsgHandler

Указатель на подпрограмму FileCallback, которая будет обрабатывать уведомления SetupIterateCabinet возвращается по мере итерирования файлов в файле кабинета. Затем подпрограмма обратного вызова может возвращать значение, указывающее, следует ли распаковывать, копировать или пропускать файл.

[in] Context

Значение контекста, передаваемое в подпрограмму, указанное в msgHandler. Это позволяет подпрограмме обратного вызова отслеживать значения между уведомлениями без использования глобальных переменных.

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

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

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Заметка

Заголовок setupapi.h определяет SetupIterateCabinet как псевдоним, который автоматически выбирает версию 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)

См. также

Функции

Обзор

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