GetFileTitleW, fonction (commdlg.h)

Récupère le nom du fichier spécifié.

Syntaxe

short GetFileTitleW(
  [in]  LPCWSTR unnamedParam1,
  [out] LPWSTR  Buf,
  [in]  WORD    cchSize
);

Paramètres

[in] unnamedParam1

Type : LPCTSTR

Nom et emplacement d’un fichier.

[out] Buf

Type : LPTSTR

Mémoire tampon qui reçoit le nom du fichier.

[in] cchSize

Type : WORD

Longueur, en caractères, de la mémoire tampon pointée par le paramètre lpszTitle.

Valeur de retour

Type : courte

Si la fonction réussit, la valeur de retour est égale à zéro.

Si le nom de fichier n’est pas valide, la valeur de retour est inconnue. En cas d’erreur, la valeur de retour est un nombre négatif.

Si la mémoire tampon pointée par le paramètre lpszTitle est trop petite, la valeur de retour est un entier positif qui spécifie la taille de mémoire tampon requise, en caractères. La taille de mémoire tampon requise inclut le caractère null de fin.

Remarques

GetFileTitle ne doit être appelé qu’avec des noms de fichiers juridiques ; l’utilisation d’un nom de fichier non défini a un résultat non défini.

Pour obtenir la taille de mémoire tampon nécessaire pour le nom d’un fichier, appelez la fonction avec lpszTitle défini sur NULL et cchSize défini sur zéro. La fonction retourne la taille requise.

GetFileTitle retourne la chaîne utilisée par le système pour afficher le nom de fichier à l’utilisateur. Le nom complet inclut une extension uniquement si c’est la préférence de l’utilisateur pour afficher les noms de fichiers. Cela signifie que la chaîne retournée peut ne pas identifier avec précision le fichier s’il est utilisé dans les appels aux fonctions du système de fichiers.

Si la mémoire tampon lpszTitle est trop petite, GetFileTitle retourne la taille requise pour contenir le nom complet. Toutefois, il n’existe aucune relation garantie entre la taille requise et les caractères spécifiés à l’origine dans la mémoire tampon lpszFile. Par exemple, n’appelez pas getFileTitle avec lpszTitle défini sur NULL et défini sur zéro, puis essayez d’utiliser la valeur de retour comme index dans la chaîne lpszFile. Vous pouvez généralement obtenir des résultats similaires (et des performances supérieures) avec des fonctions de bibliothèque d’exécution C telles que strrchr, wcsrchret _mbsrchr.

Exigences

Voir aussi

bibliothèque de boîtes de dialogue courante

conceptuelle

GetOpenFileName

GetSaveFileName

de référence