名称:GetFTitle
函式功能:该函式返回由IpszFile参数标识的档案名称。
函式原型:short GetFTitle(LPCTSTR LPTSTR IpszTitle,WORD cbBuf)
基本介绍
- 外文名:GetFTitle
- 函式原型:short GetFTitle
- 参数:IpszFile
定义
函式功能:该函式返回由IpszFile参数标识的档案名称。
函式原型:short GetFTitle(LPCTSTR LPTSTR IpszTitle,WORD cbBuf);
参数说明
IpszFile:指向一个档案名称或档案位置的指针。
IpszTitle:指向一个缓冲区,在此缓冲区中函式複製档案名称。
chBuf:指定由IpszTitle函式指向的缓冲的位元组长度。
返回值:如果函式调用成功,返回值为零;如果档案名称无效,返回值为一负值。如果由IpszTitle参数指向的缓冲区的太小,返回值为一正整数,其值指定了所需缓冲区的大小。所需缓冲区的大小还包括结尾的NULL字元。
备注:如果由IpszFile参数指向的缓冲区包含下列任何一个成员,GetFileTitle函式返回一个错误信息值。
一个空字元串;一个含有星号()、开括弧([)、闭方括弧(])的串、一个以冒号(:)、斜槓(/)或倒斜槓结尾的串;一个长度超过缓冲区长度的串;一个无效字元(如,一个空格或一个不能列印的字母):为得到档案名称所需的缓冲区的大小,用设定为NULL的IpszTitle和设定为零的cbBuf调用函式。函式将返回所需的大小。
GetFileTitle函式返回一个串,系统套用此串为用户显示档案名称。这就意味着如果返回串套用在档案系统函式的调用中不可能準确地标识档案。
如果证IpszTitle缓冲区太小,GetFile Title返回的大小需要含有显示名。在IpszFile缓冲区指定的需要的大小和字元之间没有许可的联繫。
速查:Windows NT:3.1及以上版本:Windows:95及以上版本:Windows CE:不支持:头档案:Commdlg.h;库档案:comdlg32.fib;Unicode:在Windows NT环境中实现为Unicode和ANSI两个版本。