GetFileTitle

הפונקציה GetFileTitle מחזירה את השם של קובץ מזוהה על-ידי הפרמטר lpszFile.

(GetFileTitle קצרים LPCTSTR  lpszFile, / / המצביע על הנתיב המלא ושם הקובץ עבור קובץLPTSTRlpszTitle, / / מצביע אל מאגר אשר מקבל שם קובץWORDcbBuf / / אורך מאגר);
 

פרמטרים

lpszFile
מצביע השם והמיקום של קובץ.
lpszTitle
מצביע למאגר שלתוכו הפונקציה זו כדי להעתיק את השם של קובץ.
cbBuf
מציין את האורך, בתווים, מאגר הצביע על-ידי הפרמטר lpszTitle.

להחזיר ערכים

אם הפונקציה מצליחה, הערך המוחזר הוא אפס.

אם שם הקובץ אינו חוקי, הערך המוחזר הוא מספר שלילי.

אם המאגר הצביע על-ידי הפרמטר lpszTitle קטן מדי, הערך המוחזר הוא מספר שלם חיובי מציין את גודל המאגר הדרוש, בבתים (בגירסת ANSI) או תווים של 16 סיביות (גירסת Unicode). גודל המאגר הנדרש כולל את התו null סיום.

הערות

הפונקציה GetFileTitle מחזירה ערך שגיאה אם המאגר הצביע על-ידי הפרמטר lpszFile מכילה הרכיבים הבאים:

כדי לקבל את גודל המאגר הדרוש עבור שם קובץ, לבצע קריאה לפונקציה עם lpszTitle הגדר NULL ואת cbBuf מוגדר כאפס. הפונקציה מחזירה את הגודל הנדרש.

GetFileTitle מחזירה את המחרוזת המערכת להשתמש כדי להציג את שם הקובץ למשתמש. שם התצוגה כולל סיומת רק אם זוהי ההעדפה של המשתמש עבור הצגת שמות קבצים. משמעות הדבר היא כי המחרוזת המוחזרת עשוי לא לזהות במדויק את הקובץ אם נעשה בקריאות לפונקציות מערכת קבצים.

אם המאגר lpszTitle קטן מדי, GetFileTitle מחזירה את הגודל הנדרש כדי להחזיק את שם התצוגה. אין חיבור מובטחת בין גודל נדרש התווים שצוינו במקור במאגר lpszFile . בהעברת יישומים מבוססי Windows של 16 סיביות כדי Win32, יהיה עליך לעדכן כל קוד המסתמך על התנהגות כזו בגירסאות קודמות של המערכת. המקרה הנפוץ ביותר הוא קוד שקורא בכוונה GetFileTitle עם lpszTitle הגדר NULL וערכת cbBuf לאפס ולאחר מכן משתמש הערך המוחזר כמו אינדקס למחרוזת lpszFile . טכניקה זו אינה נתמכת עוד. בדרך כלל, באפשרותך להשיג תוצאות דומות (וביצועים מעולים) עם ספריית זמן ריצה פונקציות כגון strrchr, wcsrchr, _mbsrchr.

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על commdlg.h.
ייבוא ספריית:השתמש comdlg32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.

ראה גם

סקירה נפוצות על תיבת הדו-שיח ספריית, פונקציות נפוצות של תיבת הדו-שיח, GetOpenFileName, GetSaveFileName