Funzione SetupSetFileQueueAlternatePlatformW (setupapi.h)

[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. SetupAPI non deve più essere usato 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 SetupSetFileQueueAlternatePlatformW(
  [in] HSPFILEQ             QueueHandle,
  [in] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [in] PCWSTR               AlternateDefaultCatalogFile
);

Parametri

[in] QueueHandle

Gestire in una coda di file di installazione aperta.

[in] AlternatePlatformInfo

Puntatore facoltativo a una struttura SP_ALTPLATFORM_INFO passando 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 una stringa con terminazione Null 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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	setupapi.h
Libreria	Setupapi.lib
DLL	Setupapi.dll

Vedi anche

Funzioni

Panoramica

SP_ALTPLATFORM_INFO_V1

SP_ALTPLATFORM_INFO_V2