Funzione SetupSetFileQueueAlternatePlatformA (setupapi.h)

Articolo
11/20/2024

[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive. SetupAPI non deve più essere usata per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione delle applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

La funzione SetupSetFileQueueAlternatePlatform associa la coda di file a una piattaforma di destinazione diversa dalla piattaforma che esegue la funzione. Questa operazione viene eseguita per abilitare la verifica della firma non nativa.

Sintassi

WINSETUPAPI BOOL SetupSetFileQueueAlternatePlatformA(
  [in] HSPFILEQ             QueueHandle,
  [in] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [in] PCSTR                AlternateDefaultCatalogFile
);

Parametri

[in] QueueHandle

Handle in una coda di file di installazione aperta.

[in] AlternatePlatformInfo

Puntatore facoltativo a una struttura SP_ALTPLATFORM_INFO che passa informazioni sulla piattaforma alternativa. In Windows 2000 il membro cbSize di questa struttura deve essere impostato su sizeof(SP_ALTPLATFORM_INFO_V1). In Windows Server 2003 o Windows XP il membro cbSize di questa struttura deve essere impostato su sizeof(SP_ALTPLATFORM_INFO_V2).

[in] AlternateDefaultCatalogFile

Puntatore a un nullstringa con terminazione che specifica un catalogo che convalida tutti i file INF. Questo parametro può essere NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Nota

L'intestazione setupapi.h definisce SetupSetFileQueueAlternatePlatform come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	setupapi.h
libreria	Setupapi.lib
dll	Setupapi.dll

Vedere anche

Funzioni

panoramica

SP_ALTPLATFORM_INFO_V1

SP_ALTPLATFORM_INFO_V2

Condividi tramite