GetFileTitle

ฟังก์ชันGetFileTitleจะส่งกลับค่าชื่อของแฟ้มที่ระบุพารามิเตอร์lpszFile.

(GetFileTitle สั้น LPCTSTR  lpszFile, / / ชี้เส้นทางแบบเต็มและชื่อแฟ้มสำหรับแฟ้มLPTSTRlpszTitle, / / ชี้การบัฟเฟอร์ที่ได้รับชื่อแฟ้มWORDcbBuf / / ความยาวของบัฟเฟอร์);
 

พารามิเตอร์

lpszFile

ชี้ไปยังชื่อและตำแหน่งของแฟ้ม.

lpszTitle

ชี้การบัฟเฟอร์ที่ฟังก์ชันคือการ คัดลอกชื่อของแฟ้ม.

cbBuf

ระบุความยาว ในตัวอักษร การบัฟเฟอร์ที่ชี้ไปตามพารามิเตอร์lpszTitle.

ส่งกลับค่า

ถ้าฟังก์ชันสำเร็จ ส่งคืนค่าเป็นศูนย์.

ถ้าชื่อแฟ้มไม่ถูกต้อง ส่งคืนค่าเป็นตัวเลขที่เป็นค่าลบ.

ถ้าชี้ไปตามพารามิเตอร์lpszTitleบัฟเฟอร์มีขนาดเล็กเกินไป ส่งคืนค่าเป็นจำนวนเต็มบวกที่ระบุขนาดของบัฟเฟอร์ที่จำเป็น ไบต์ (รุ่น ANSI) หรืออักขระ 16 บิต (รุ่น Unicode) ขนาดของบัฟเฟอร์ที่จำเป็นรวมถึงอักขระ null terminating.

หมายเหตุ

ฟังก์ชันGetFileTitleจะส่งกลับค่าข้อผิดพลาดถ้าประกอบด้วยบัฟเฟอร์ที่ชี้ไปตามพารามิเตอร์lpszFileใดองค์ประกอบต่อไปนี้:

• สตริงว่าง
• สายอักขระประกอบด้วยอักขระตัวแทน (*), เปิดวงเล็บเหลี่ยม ([]), หรือวงเล็บเหลี่ยมปิด (])
• สายอักขระที่ลงท้าย ด้วยเครื่องหมายจุดคู่ทับ (:), หน้าเครื่องหมาย (/), หรือเครื่องหมายทับขวา (\)
• สตริงที่มีความยาวเกินความยาวของบัฟเฟอร์
• อักขระไม่ถูกต้อง (ตัวอย่างเช่น ช่องว่างหรืออักขระ unprintable)

ขนาดของบัฟเฟอร์จำเป็นสำหรับชื่อของแฟ้มที่ได้รับ เรียกใช้ฟังก์ชันกับlpszTitleตั้งค่า NULL และcbBufการตั้งค่าเป็นศูนย์ ฟังก์ชันจะส่งกลับขนาดจำเป็น.

GetFileTitleส่งกลับสตริงที่ต้องใช้ระบบเพื่อแสดงชื่อแฟ้มสำหรับผู้ใช้ ชื่อที่ใช้แสดงมีส่วนขยายเท่านั้นหากเป็นผู้กำหนดลักษณะการแสดงชื่อแฟ้ม ซึ่งหมายความ ว่า สตริงที่ส่งกลับอาจไม่ถูกต้องระบุแฟ้มถ้ามีใช้ในการเรียกไปยังฟังก์ชันของระบบแฟ้ม.

ถ้าlpszTitleบัฟเฟอร์มีขนาดเล็กเกินไปGetFileTitleส่งกลับค่าขนาดจำเป็นเพื่อเก็บชื่อที่ใช้แสดง ไม่มีการรับประกันมีการเชื่อมต่อระหว่างขนาดจำเป็นและอักขระแต่เดิม ถูกระบุในบัฟเฟอร์lpszFile ในโปรแกรมประยุกต์ที่ใช้ Windows 16 บิตเพื่อ Win32 ที่++:การสร้างพอร์ต คุณจำเป็นต้องปรับปรุงโค้ดใด ๆ ที่อาศัยเช่นลักษณะการทำงานในรุ่นก่อนหน้าของระบบ กรณีพบบ่อยที่สุดคือ รหัสที่เจตนาเรียกGetFileTitleกับlpszTitleการตั้งค่าการตั้งค่า NULL และcbBufเป็นศูนย์ และใช้ค่าส่งกลับเป็นดัชนีลงในสตริlpszFile เทคนิคนี้ไม่ได้รับการสนับสนุน คุณสามารถจะบรรลุผลลัพธ์ที่คล้ายคลึงกัน (และประสิทธิภาพ superior) กับไลบรารีรันไทม์ฟังก์ชันเช่นstrrchr, wcsrchrและ_mbsrchr.

QuickInfo

nbsp Windows &NT:ต้องการเวอร์ชัน 3.1 หรือรุ่นที่ใหม่กว่า
Windows:ต้องใช้ Windows 95 หรือรุ่นที่ใหม่กว่า
Windows CE:ไม่สนับสนุน
หัวข้อ:ประกาศใน commdlg.h
ไลบรารีที่นำเข้า:ใช้ comdlg32.lib
Unicode:นำมาใช้เป็น Unicode และ ANSI รุ่นบน Windows NT.

ดูเพิ่มเติม

ภาพรวมไลบรารีของกล่องโต้ตอบทั่วไปฟังก์ชันกล่องโต้ตอบทั่วไป GetOpenFileName, GetSaveFileName