Функция SetupCommitFileQueueW (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]
Функция SetupCommitFileQueue выполняет операции с файлами, помещенные в очередь файлов установки.
Рекомендуется собрать все необходимые операции с файлами для очереди файлов и зафиксировать очередь только один раз, так как очередь файлов не может быть использована повторно после фиксации. Если после фиксации требуется дополнительная обработка очереди, дескриптор очереди должен быть закрыт и создана новая очередь файлов. Дополнительные сведения см. в разделе Фиксация очереди.
При изменении файла вызывающий объект этой функции должен иметь права на запись в целевой каталог.
Синтаксис
WINSETUPAPI BOOL SetupCommitFileQueueW(
[in] HWND Owner,
[in] HSPFILEQ QueueHandle,
[in] PSP_FILE_CALLBACK_W MsgHandler,
[in] PVOID Context
);
Параметры
[in] Owner
Необязательный дескриптор для окна, используемого в качестве родительского для любых диалоговых окон хода выполнения.
[in] QueueHandle
Дескриптор очереди файла установки, возвращенный setupOpenFileQueue.
[in] MsgHandler
Указатель на необязательную подпрограмму обратного вызова для уведомления о различных значимых событиях, которые находятся в обработке очереди. Дополнительные сведения см. в разделах Подпрограмма обратного вызова очереди по умолчанию или FileCallback Если подпрограмма обратного вызова имеет значение NULL, SetupCommitFileQueue возвращает значение TRUE и ошибка 0 или NO_ERROR.
[in] Context
Значение, передаваемое функции обратного вызова, предоставленной параметром MsgHandler . Если подпрограмма обратного вызова по умолчанию указана как MsgHandler, этот контекст должен быть контекстом, возвращаемым из SetupInitDefaultQueueCallback или SetupInitDefaultQueueCallbackEx.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет ненулевым.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Подпрограмма обратного вызова, указанная в MsgHandler , должна быть совместима с параметрами, переданными SetupCommitFileQueue во время фиксации очереди.
Если в приложении обратного вызова определен Юникод и вы указываете MsgHandler в качестве подпрограммы обратного вызова очереди по умолчанию, подпрограмма обратного вызова будет ожидать параметры Юникода. В противном случае подпрограмма обратного вызова очереди по умолчанию будет ожидать параметры ANSI.
Примечание
Заголовок setupapi.h определяет SetupCommitFileQueue в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | setupapi.h |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |