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

Статья
11/20/2024

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

Функция setupSetFileQueueAlternatePlatform связывает очередь файлов с целевой платформой, отличной от платформы, выполняющей функцию. Это делается для проверки подписи, отличной от машинного кода.

Синтаксис

WINSETUPAPI BOOL SetupSetFileQueueAlternatePlatformW(
  [in] HSPFILEQ             QueueHandle,
  [in] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [in] PCWSTR               AlternateDefaultCatalogFile
);

Параметры

[in] QueueHandle

Обработка очереди открытых файлов установки.

[in] AlternatePlatformInfo

Необязательный указатель на структуру SP_ALTPLATFORM_INFO, передавая сведения о альтернативной платформе. В Windows 2000 cbSize элемент этой структуры должен иметь значение sizeof(SP_ALTPLATFORM_INFO_V1). В Windows Server 2003 или Windows XP cbSize элемент этой структуры должен иметь значение sizeof(SP_ALTPLATFORM_INFO_V2).

[in] AlternateDefaultCatalogFile

Указатель на строку null-terminated, указывающую каталог, который проверяет все INF-файлы. Этот параметр может быть null.

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

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

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

Замечания

Заметка

Заголовок setupapi.h определяет SetupSetFileQueueAlternatePlatform в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	setupapi.h
библиотеки	Setupapi.lib
DLL	Setupapi.dll

См. также

Функции

Обзор

SP_ALTPLATFORM_INFO_V1

SP_ALTPLATFORM_INFO_V2

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