GetFileTitle

Funkcia GetFileTitle vráti názov súboru identifikovaný parametrom lpszFile.

GetFileTitle (krátkej)  LPCTSTR  lpszFile; / / ukazovateľ na úplnú cestu a názov súboru pre súborLPTSTRlpszTitle; / / ukazovateľ tlmivého roztoku, ktorý dostane filenameProgram WORDcbBuf / / dĺžka medzipamäte);
 

Parametre

lpszFile

Ukazovateľ na názov a umiestnenie súboru.

lpszTitle

Ukazovateľ do medzipamäte, do ktorého funkciou je skopírovať názov súboru.

cbBuf

Určuje dĺžku znakov medzipamäte poukázal parametra lpszTitle.

Note:

Ak funkciu podarí, vrátená hodnota je nula.

Ak názov súboru je neplatný, vrátená hodnota je záporné číslo.

Ak medzipamäť poukázal na lpszTitle parameter je príliš malá, vrátená hodnota je kladné celé číslo, ktoré určuje veľkosť vyžaduje medzipamäte v bajtoch (ANSI verzia) alebo 16-bitové znaky (Unicode verzia). Veľkosť medzipamäte vyžaduje obsahuje koncový znak null.

Poznámky

Funkcia GetFileTitle vráti chybovú hodnotu ak medzipamäť poukázal na lpszFile parameter obsahuje niektorý z týchto prvkov:

• Našiel sa prázdny reťazec
• Reťazec, ktorý obsahuje zástupný znak mesiacov8, otvorenie hranatá zátvorka ([]) alebo hranatú zátvorku (])
• Reťazec, ktorý končí s dvojbodkou (:), lomka známky (/) alebo opačné lomky (\)
• Reťazec, ktorého dĺžka prekročené dĺžka medzipamäte
• Neplatný znak (napríklad medzeru alebo hrubý znakov)

Získať potrebné pre názov súboru veľkosť medzipamäte volať funkciu s lpszTitle nastavená na hodnotu NULL a cbBuf nastavia na nulu. Funkcia vráti požadovanú veľkosť.

GetFileTitle vráti reťazec, že systém by použiť na zobrazenie názvu súboru používateľovi. Zobrazovaný názov zahŕňa rozšírenie iba v prípade, že je užívateľské preferencie pre zobrazovanie súborov. To znamená, že vrátený reťazec môže nedokázal presne identifikovať súbor použití vo volaní funkcie systému súborov.

Ak lpszTitle medzipamäť je príliš malá, GetFileTitle vráti veľkosť povinná držať zobrazované meno. Neexistuje žiadna garantované súvislosť medzi požadovanú veľkosť a znakov pôvodne určenú lpszFile medzipamäte. V portování 16-bitové systémom Windows aplikácie pre Win32, budete musieť aktualizovať kód, ktorý sa spolieha na takéto správanie v predchádzajúcich verziách systému. Najčastejší prípad je kód, ktorý úmyselne vyžaduje GetFileTitle s lpszTitle nastavená na hodnotu NULL a cbBuf nastavený na nulu a potom použije hodnotu vrátenú funkciou ako index do lpszFile reťazca. Táto technika už nie je podporovaná. Run-time knižnici funkcie ako napríklad strrchr, wcsrchra _mbsrchr môže zvyčajne dosiahnuť podobné výsledky (a vynikajúci výkon).

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verzia 3.1 alebo novšia.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Nepodporované.
Hlavičky:Deklarovaný v commdlg.h.
Importovať knižnica:Použiť comdlg32.lib.
Unicode:Implementovaný ako Unicode, ANSI verzia v systéme Windows NT.

Pozri tiež

Spoločné Prehľad dialógového okna Knižnica spoločných Dialog Box funkcií, GetOpenFileName, GetSaveFileName