GetFileTitle

GetFileTitle işlevi lpszFile parametresi tarafından tanımlanan dosya ismini döndürür.

kısa GetFileTitle) lpctstr  lpszFile, / / tam yolunu ve dosya adını dosya işaretçisilptstrlpszTitle, / / bu tampon işaretçi alır dosya adıwordcbBuf / / arabellek uzunluğu);
 

Parametreleri

lpszFile

İşaretçi bir dosya konumu ve adı.

lpszTitle

Arabellek içine dosyanın adını kopyalamak işlevidir işaretçisine.

cbBuf

Karakterler, lpszTitle parametresi tarafından işaret arabellek uzunluğu belirtir.

Dönüş değerleri

İşlev başarılı olursa, dönüş değeri sıfırdır.

Dosya adı geçersiz dönüş değeri negatif bir sayı ise,.

LpszTitle parametresi tarafından işaret arabellek çok küçük ise, dönüş değeri gerekli arabellek boyutu, bayt (ANSI sürümü) veya 16-bit karakter (Unicode sürümü) olarak belirten bir pozitif tamsayıdır. Sonlandırıcı boş karakter gerekli arabellek boyutunu içerir.

Açıklamalar

LpszFile parametresi tarafından işaret arabellek aşağıdaki öğelerden birini içeriyorsa, GetFileTitle işlevi hata değerini döndürür.:

• Boş dize
• Açılış köşeli ayraç ([]) veya Kapanış köşeli ayraç (]) joker karakter (*) içeren bir dize
• İki nokta ile sonlanan bir dize (:), bölme işareti (/) veya ters eğik çizgi (\)
• Bir dize uzunluğunu arabellek uzunluğu aşıldı
• Geçersiz bir karakter (örneğin, bir alan veya yazdırılamayan bir karakter)

-E doğru almak için bir dosya adı gerekli arabellek boyutu, boş ve sıfır olarak ayarlamak cbBuf lpszTitle ile işlevini çağırın. Gereken boyut döndürür.

GetFileTitle sistem, kullanıcı dosya adını görüntülemek için kullanacağı dizesini döndürür. Sadece bu dosya adlarını görüntülemek için kullanıcının tercihi ise görüntü adı uzantı içerir. Bu dosya sistemi işlevleri çağrıları kullanıldığında döndürülen dize doğru dosya tanıtabilecek değil ki anlamına gelir.

LpszTitle arabellek çok küçük ise, GetFileTitle görünen adını saklamak için gereken döndürür. Gereken boyut ve lpszFile arabellekte özgün olarak belirttiğiniz karakter arasında garantili bir bağlantı yoktur. 16 Bitlik Windows tabanlı uygulamaları Win32 taşımak içinde sistem önceki sürümlerinde bu tür davranış dayanan herhangi bir kodu güncelleştirmeniz gerekir. En yaygın durum kasten boş ve cbBuf sıfıra ayarlayın lpszTitle ile GetFileTitle çağıran kod ve dönüş değeri lpszFile dizeye dizin olarak kullanır. Bu tekniği artık desteklenmiyor. Strrchr, wcsrchrve _mbsrchr gibi çalışma kütüphane işlevleri ile benzer sonuçlar (ve üstün performans) genellikle ulaşabilirsiniz.

QuickInfo

nbsp; Windows &NT: sürüm 3.1 veya üstü gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Desteklenmeyen.
Header:Commdlg.h ilan etti.
İçe Library:Comdlg32.lib kullanın.
Unicode:Unicode ve ANSI sürümleri Windows NT olarak uygulanır.

Ayrıca bkz:

Ortak iletişim kutusuna kitaplığın genel bakış, ortak iletişim kutusundaki işlevler, GetOpenFileName, GetSaveFileName