SetupSetDirectoryIdExA, fonction (setupapi.h)

  • Article

[Cette fonction peut être utilisée 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 installer des applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour installer les pilotes de périphérique.]

La fonction SetupSetDirectoryIdEx associe un identificateur de répertoire dans un fichier INF à un répertoire spécifique.

Syntaxe

WINSETUPAPI BOOL SetupSetDirectoryIdExA(
  [in] HINF  InfHandle,
  [in] DWORD Id,
  [in] PCSTR Directory,
  [in] DWORD Flags,
       DWORD Reserved1,
       PVOID Reserved2
);

Paramètres

[in] InfHandle

Handle pour un fichier INF chargé.

[in] Id

Identificateur d’annuaire (DIRID) à utiliser pour une association. Ce paramètre peut être NULL. Ce DIRID doit être supérieur ou égal à DIRID_USER. Si une association existe déjà pour ce DIRID, elle est remplacée. Si Id est égal à zéro, le paramètre Directory est ignoré et l’ensemble actuel de DIRIDs définis par l’utilisateur est supprimé.

[in] Directory

Pointeur vers une chaîne terminée par null qui spécifie le chemin d’accès au répertoire à associer à l’ID. Ce paramètre peut être NULL. Si Directory a la valeur NULL, tout répertoire associé à Id n’est pas associé. Aucune erreur ne se produit si Id n’est actuellement associé à un répertoire.

[in] Flags

Ce paramètre peut être défini sur SETDIRID_NOT_FULL_PATH (1) pour indiquer que le répertoire ne spécifie pas de chemin d’accès complet.

Reserved1

Si la valeur de ce paramètre n’est pas zéro, la fonction retourne ERROR_INVALID_PARAMETER.

Reserved2

Si la valeur de ce paramètre n’est pas zéro, la fonction retourne ERROR_INVALID_PARAMETER.

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 zéro (0). Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

SetupSetDirectoryIdEx peut être utilisé avant la mise en file d’attente des opérations de copie de fichiers pour spécifier un emplacement cible connu uniquement au moment de l’exécution.

Après avoir défini l’identificateur de répertoire, cette fonction traverse tous les fichiers INF ajoutés, et si l’un d’eux a des substitutions de chaîne non résolues, la fonction tente de leur appliquer à nouveau la substitution de chaîne en fonction du nouveau mappage DIRID. Pour cette raison, certaines valeurs INF peuvent changer après l’appel de SetupSetDirectoryIdEx.

DIRID_ABSOLUTE_16BIT n’est pas une valeur valide pour Id, ce qui garantit la compatibilité avec l’installation 16 bits.

Notes

L’en-tête setupapi.h définit SetupSetDirectoryIdEx comme 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. La combinaison 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