STRUCTURE SHNAMEMAPPINGA (shellapi.h)

Article
11/20/2024

Contient les noms de chemin d’accès anciens et nouveaux pour chaque fichier déplacé, copié ou renommé par la fonction SHFileOperation.

Syntaxe

typedef struct _SHNAMEMAPPINGA {
  LPSTR pszOldPath;
  LPSTR pszNewPath;
  int   cchOldPath;
  int   cchNewPath;
} SHNAMEMAPPINGA, *LPSHNAMEMAPPINGA;

Membres

pszOldPath

Type : LPTSTR

Adresse d’une mémoire tampon de caractères qui contient l’ancien nom du chemin d’accès.

pszNewPath

Type : LPTSTR

Adresse d’une mémoire tampon de caractères qui contient le nouveau nom du chemin d’accès.

cchOldPath

Type : int

Nombre de caractères dans pszOldPath.

cchNewPath

Type : int

Nombre de caractères dans pszNewPath.

Remarques

Il existe deux versions de cette structure, une version ANSI (SHFILEOPSTRUCTA) et une version Unicode (SHFILEOPSTRUCTW). La version Unicode est identique à la version ANSI, sauf que les chaînes de caractères larges (LPCWSTR) sont utilisées à la place de chaînes de caractères ANSI (LPCSTR). Sur Windows 98 et versions antérieures, seule la version ANSI est prise en charge. Sur Microsoft Windows NT 4.0 et versions ultérieures, les versions ANSI et Unicode de cette structure sont prises en charge. SHNAMEMAPPINGA et SHNAMEMAPPINGW ne doivent jamais être utilisés directement ; la structure appropriée est redéfinie comme SHNAMEMAPPING par le précompileur selon que l’application est compilée pour ANSI ou Unicode.

Note

L’en-tête shellapi.h définit SHNAMEMAPPING en tant qu’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 2000 Server [applications de bureau uniquement]
d’en-tête	shellapi.h

Voir aussi

SHFILEOPSTRUCT

Partager via