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

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

  • Статья

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

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

Синтаксис

WINSETUPAPI BOOL SetupSetFileQueueAlternatePlatformA(
  [in] HSPFILEQ             QueueHandle,
  [in] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [in] PCSTR                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

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

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

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

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

Комментарии

Примечание

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

Требования

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

См. также

Функции

Обзор

SP_ALTPLATFORM_INFO_V1

SP_ALTPLATFORM_INFO_V2