Funzione SetupSetPlatformPathOverrideW (setupapi.h)

[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 SetupSetPlatformPathOverride viene usata per impostare un override del percorso della piattaforma per un computer di destinazione quando si usano file 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 non 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 un nullstringa con terminazione contenente le informazioni sulla piattaforma sostitutiva. Ad esempio, "alpha" 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Se getLastError restituisce ERROR_NOT_ENOUGH_MEMORY, SetupSetPlatformPathOverride non è riuscito a archiviare la stringa override .

Osservazioni

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 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, the path will be changed to \pop\top\baz\alpha\x.exe.

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

Fabbisogno

Vedere anche

Funzioni

panoramica

SetupSetDirectoryId