Fonction SetupSetPlatformPathOverrideA (setupapi.h)

[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. SetupAPI ne doit plus être utilisé pour l’installation d’applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour l’installation des pilotes de périphérique.]

La fonction SetupSetPlatformPathOverride est utilisée pour définir un remplacement de chemin de plateforme pour une machine cible lors de l’utilisation d’INFs à partir d’un autre ordinateur. Par conséquent, il peut faire référence à une plateforme différente de celle sur laquelle elle s’exécute actuellement. Pour traiter les sources multimédias, il peut faire référence à des plateformes qui ne sont plus prises en charge, telles que Alpha, MIPS et PPC. Il supprime le remplacement du chemin d’accès de la plateforme si aucun n’est spécifié.

Syntaxe

WINSETUPAPI BOOL SetupSetPlatformPathOverrideA(
  [in] PCSTR Override
);

Paramètres

[in] Override

Pointeur vers une chaîne terminée par null qui contient les informations de la plateforme de remplacement. Par exemple, « alpha » ou « x86 ». Ce paramètre peut avoir la valeur NULL.

Valeur retournée

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Si GetLastError retourne ERROR_NOT_ENOUGH_MEMORY, SetupSetPlatformPathOverride n’a pas pu stocker la chaîne Override .

Remarques

SetPlatformPathOverride est utilisé pour modifier le chemin d’accès source lors de la mise en file d’attente des fichiers. Si un remplacement de chemin de plateforme a été défini par un appel à SetPlatformPathOverride, toute fonction d’installation qui met en file d’attente des opérations de copie de fichier examine le composant final du chemin source et si le composant final correspond au nom de la plateforme de l’utilisateur, remplacez-le par la chaîne de remplacement définie par SetPlatformPathOverride.

Par exemple, considérez une machine de plateforme MIPS où la plateforme a été définie sur Alpha par un appel à SetPlatformPathOverride. Une fois le remplacement du chemin de plateforme défini, une opération de copie de fichiers est mise en file d’attente avec un chemin source de \pop\top\baz\mips\x.exe, le chemin d’accès est remplacé par \pop\top\baz\alpha\x.exe.

Les chemins d’accès des opérations de copie de fichiers mis en file d’attente avant la définition du remplacement du chemin d’accès ne sont pas modifiés.

Notes

L’en-tête setupapi.h définit SetupSetPlatformPathOverride comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	setupapi.h
Bibliothèque	Setupapi.lib
DLL	Setupapi.dll

Voir aussi

Fonctions

Vue d'ensemble

SetupSetDirectoryId