-
GetFileTitle
鎖定
GetFileTitle返回由IpszFile參數標識的文件名。
- 中文名
- GetFileTitle
- 功 能
- 返回由IpszFile參數標識的文件名
- 原 型
- short GetFileTitle
- 參 數
- IpszFile,IpszTitle,chBuf
GetFileTitle函數原型
short GetFileTitle( LPCTSTR lpszFile, LPTSTR lpszTitle, WORD cbBuf);
GetFileTitle參數
IpszFile:指向一個文件名或文件位置的指針。
IpszTitle:指向一個緩衝區,在此緩衝區中函數複製文件名。
chBuf:指定由IpszTitle函數指向的緩衝的字節長度。
GetFileTitle返回值
如果函數調用成功,返回值為零;如果文件名無效,返回值為一負值。如果由IpszTitle參數指向的緩衝區的太小,返回值為一正整數,其值指定了所需緩衝區的大小。所需緩衝區的大小還包括結尾的NULL字符。
GetFileTitle其他信息
如果由IpszFile參數指向的緩衝區包含下列任何一個成員,GetFileTitle函數返回一個錯誤信息值。
一個空字符串;一個含有星號( )、開括號([)、閉方括號(])的串、一個以冒號(:)、斜槓(/)或倒斜槓結尾的串;一個長度超過緩衝區長度的串;一個無效字符(如,一個空格或一個不能打印的字母):為得到文件名所需的緩衝區的大小,用設置為NULL的IpszTitle和設置為零的cbBuf調用函數。函數將返回所需的大小。
GetFileTitle函數返回一個串,系統應用此串為用户顯示文件名。這就意味着如果返回串應用在文件系統函數的調用中不可能準確地標識文件。
如果證IpszTitle緩衝區太小,GetFile Title返回的大小需要含有顯示名。在IpszFile緩衝區指定的需要的大小和字符之間沒有許可的聯繫。
GetFileTitle速查
Windows NT:3.1及以上版本:Windows:95及以上版本:Windows CE:不支持:頭文件:Commdlg.h;庫文件:comdlg32.lib;Unicode:在Windows NT環境中實現為Unicode和ANSI兩個版本。
- 詞條統計
-
- 瀏覽次數:次
- 編輯次數:10次歷史版本
- 最近更新: lanuie3784