Funzione SetupSetPlatformPathOverrideW (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 SetupSetPlatformPathOverride viene usata per impostare un override del percorso della piattaforma per un computer di destinazione quando si usano funzioni INFS da un computer diverso. Di conseguenza, può fare riferimento a una piattaforma diversa da quella attualmente in esecuzione. Per gestire le origini multimediali, può fare riferimento a piattaforme che non sono più supportate, ad esempio Alpha, MIPS e PPC. Rimuove l'override del percorso della piattaforma se non è specificato alcun valore.

Sintassi

WINSETUPAPI BOOL SetupSetPlatformPathOverrideW(
  [in] PCWSTR Override
);

Parametri

[in] Override

Puntatore a una stringa con terminazione Null contenente le informazioni sulla piattaforma sostitutiva. Ad esempio, "alfa" o "x86". 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.

Se GetLastError restituisce ERROR_NOT_ENOUGH_MEMORY, SetupSetPlatformPathOverride non è riuscito a archiviare la stringa Override .

Commenti

SetPlatformPathOverride viene usato per modificare il percorso di origine durante l'accodamento dei file. Se un override del percorso della piattaforma è stato impostato da una chiamata a SetPlatformPathOverride, qualsiasi funzione di installazione che accoda le operazioni di copia file esaminerà il componente finale del percorso di origine e se il componente finale corrisponde al nome della piattaforma dell'utente, sostituirlo con la stringa di override impostata da SetPlatformPathOverride.

Si consideri ad esempio un computer della piattaforma MIPS in cui la piattaforma è stata impostata su Alpha da una chiamata a SetPlatformPathOverride. Dopo aver impostato l'override del percorso della piattaforma, un'operazione di copia file viene accodata con un percorso di origine di \pop\top\baz\mips\x.exe, il percorso verrà modificato in \pop\top\baz\alpha\x.exe.

I percorsi delle operazioni di copia file accodati prima dell'override del percorso non vengono modificati.

Nota

L'intestazione setupapi.h definisce SetupSetPlatformPathOverride 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

Requisito	Valore
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

SetupSetDirectoryId