structure FILEPATHS_A (setupapi.h)

Article
03/04/2024

La structure FILEPATHS stocke les informations de chemin d’accès source et cible. Les fonctions d’installation envoient la structure FILEPATHS en tant que paramètre dans plusieurs notifications envoyées aux routines de rappel. Pour plus d’informations, consultez Notifications.

Syntaxe

typedef struct _FILEPATHS_A {
  PCSTR Target;
  PCSTR Source;
  UINT  Win32Error;
  DWORD Flags;
} FILEPATHS_A, *PFILEPATHS_A;

Membres

Target

Chemin du fichier cible.

Source

Chemin du fichier source. Ce membre n’est pas utilisé lorsque la structure FILEPATHS est utilisée avec une opération de suppression de fichier.

Win32Error

Si une erreur se produit, ce membre est le code d’erreur système. Si aucune erreur ne s’est produite, elle est NO_ERROR.

Flags

Informations supplémentaires qui dépendent de la notification envoyée avec la structure FILEPATHS .

Pour SPFILENOTIFY_COPYERROR notifications, Indicateurs spécifie le comportement de boîte de dialogue et peut être l’une des valeurs suivantes.

Valeur	Signification
SP_COPY_NOBROWSE	Ne proposez pas à l’utilisateur la possibilité de parcourir.
SP_COPY_NOSKIP	N’offrez pas à l’utilisateur la possibilité d’ignorer le fichier.
SP_COPY_WARNIFSKIP	Informez l’utilisateur que l’omission du fichier peut affecter l’installation.

Pour SPFILENOTIFY_FILEOPDELAYED notifications, Flags spécifie le type d’opération de fichier retardée et peut être l’une des valeurs suivantes.

Valeur	Signification
FILEOP_COPY	Une opération de copie de fichiers a été retardée.
FILEOP_DELETE	Une opération de suppression de fichier a été retardée.

Remarques

Notes

L’en-tête setupapi.h définit FILEPATHS 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]
En-tête	setupapi.h

Voir aussi

Vue d'ensemble

Structures

Partager via