structure FILEPATHS_W (setupapi.h)

Article
11/20/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_W {
  PCWSTR Target;
  PCWSTR Source;
  UINT   Win32Error;
  DWORD  Flags;
} FILEPATHS_W, *PFILEPATHS_W;

Membres

Target

Chemin d’accès au fichier cible.

Source

Chemin d’accès au 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 n’a eu lieu, elle est NO_ERROR.

Flags

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

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

Valeur	Signification
SP_COPY_NOBROWSE	Ne proposez pas à l’utilisateur l’option de parcourir.
SP_COPY_NOSKIP	Ne proposez pas à l’utilisateur l’option d’ignorer le fichier.
SP_COPY_WARNIFSKIP	Informez l’utilisateur qui ignore le fichier peut affecter l’installation.

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

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

Remarques

Note

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
d’en-tête	setupapi.h

Voir aussi

Vue d’ensemble

structures

Partager via