GetFileTitle

Declare Function Api_GetFileTitle% Lib "comdlg32" Alias "GetFileTitleA" (ByVal lpszFile$, ByVal lpszTitle$, ByVal cbBuf%)

Declare Function GetFileTitle Lib "comdlg32" Alias "GetFileTitleA" (ByVal lpszFile As String, ByVal lpszTitle As String, ByVal cbBuf As Integer) As Integer

指定されたファイルの名前を取得する。

パラメータ
lpszFile
    ［入力］フルパス名（ ファイルの場所とファイル名）へのポインタを指定する。
lpszTitle
    ［出力］ファイル名を受け取るバッファへのポインタを指定する。
cbBuf
    ［入力］lpszTitle パラメータが指すバッファの長さを TCHAR 単位で指定する。

戻り値
    関数が成功すると、0 が返る。
    ファイル名が無効の場合、負の値が返る。
    lpszTitle パラメータが指すバッファが小さすぎるときは、必要なバッファのサイズを表す正の整数が TCHAR 単位で返る。

    返されるバッファサイズには、終わりの null 文字が含まれている。

解説
    lpszFile パラメータが指すバッファに次のいずれかの要素が含まれていると、GetFileTitle 関数はエラーを返す。
    ・空の文字列
    ・ワイルドカード（*）、左角かっこ（[）、右角かっこ（]）のいずれかを含む文字列
    ・コロン（:）、スラッシュ（/）、または円記号（\）で終わる文字列
    ・バッファより長い文字列
    ・無効な文字（ たとえば、半角スペースや表示不可能な文字）
    ファイル名の取得に必要なバッファのサイズを得るには、lpszTitle パラメータに NULL を、cbBuf パラメータに 0 を指定して、この関数を呼  

    び出す。するとこの関数は、必要なサイズを返す。