IFileDialog ::GetFileName, méthode (shobjidl_core.h)

Récupère le texte actuellement entré dans la zone d’édition Nom de fichier de la boîte de dialogue.

Syntaxe

HRESULT GetFileName(
  [out] LPWSTR *pszName
);

Paramètres

[out] pszName

Type : WCHAR**

Adresse d’un pointeur vers une mémoire tampon qui, lorsque cette méthode retourne correctement, reçoit le texte.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le texte de la zone d’édition Nom de fichier ne reflète pas nécessairement l’élément choisi par l’utilisateur. Pour obtenir l’élément choisi par l’utilisateur, utilisez IFileDialog ::GetResult.

L’application appelante est chargée de libérer la mémoire tampon récupérée à l’aide de la fonction CoTaskMemFree .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)