GetFileTitle

GetFileTitle funcţia întoarce numele fişierului identificate de parametrul lpszFile.

(GetFileTitle scurt)  LPCTSTR  lpszFile, / / indicatorul la calea completă şi numele de fişier pentru fişierulLPTSTRlpszTitle, / / indicatorul de care primeşte filenameWORDcbBuf / / lungime tampon);
 

Parametrii

lpszFile

Indicatorul de numele şi locaţia unui fişier.

lpszTitle

Indicatorul pentru a o tampon în care funcţia este de a copia numele fişierului.

cbBuf

Specifică lungimea, caractere, de tampon a subliniat de parametrul lpszTitle.

Valorile întroarse

Dacă funcţia reuşeşte, valoarea returnată este zero.

Dacă numele fişierului este nevalid, valoarea returnată este un număr negativ.

Dacă zona tampon a subliniat de parametrul lpszTitle este prea mică, valoarea returnată este un întreg pozitiv care specifică dimensiunea necesară tampon, în octeţi (ANSI versiunea) sau 16-bit caractere (versiunea Unicode). Dimensiune tampon necesare include caracterul null care.

Observaţii

GetFileTitle funcţia întoarce o valoare de eroare dacă tampon a subliniat de parametrul lpszFile conţine următoarele elemente:

• Un şir vid
• Un string conţinând un metacaracter, Deschidere paranteză ([]), sau paranteza dreaptă de închidere (])
• Şir de caractere care se termină cu două puncte (:), slash marca (/), sau bară oblică inversă (\)
• Şir de caractere ale căror lungime depă?e?te lungimea tamponului
• Un caracter nevalid (de exemplu, un spaţiu sau un caracter indecent)

Pentru a obţine mărimea tampon necesare pentru numele unui fişier, apela funcţia cu lpszTitle setată la nul şi cbBuf setate la zero. Funcţia va întoarce dimensiunea cerută.

GetFileTitle întoarce şirul care sistemul ar folosi pentru a afişa numele fişierului pentru utilizator. Numele afişat include o extensie numai în cazul în care este utilizatorului preferinţă pentru afişarea fişierelor. Acest lucru înseamnă că string-ul întors poate nu exact identifica fişierul dacă este utilizat în apelurile pentru fişierul sistem funcţii.

Dacă zona-tampon lpszTitle este prea mică, GetFileTitle întoarce dimensiunea trebuie să de?ină ?i numele afişat. Nu există nici o legătură garantat între dimensiunea cerută şi caractere specificat iniţial în zona-tampon lpszFile . În transferabilitatea 16-bit Ferestre-bază cerere pentru Win32, aveţi nevoie pentru a actualiza orice cod care se bazează pe astfel de comportament în versiunile anterioare ale sistemului. Cazul cel mai frecvent este codul care solicită în mod deliberat GetFileTitle cu lpszTitle setată la set NULL şi cbBuf la zero, şi apoi utilizează valoarea returnată ca un index în şirul de lpszFile . Această tehnică nu mai este acceptat. Puteţi de obicei obţine rezultate similare (şi performanţe superioare) cu run-time biblioteci funcţii cum ar fi strrchr, wcsrchrşi _mbsrchr.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Neacceptat.
Antet:A declarat în commdlg.h.
Import Biblioteca:Utilizarea comdlg32.lib.
Unicode:Pus în aplicare ca Unicode şi ANSI versiuni Windows NT.

A se vedea, de asemenea

Comune Dialog Box biblioteca prezentare generală, funcţii comune de caseta de Dialog, GetOpenFileName, GetSaveFileName