FindFirstFile(API)でファイルを検索

指定したファイルを検索します。
また、ワイルドカード(*)を使用することによりディレクトリ内の全ファイルを
検索対象とすることが出来ます。ワイルドカード(*)を使用して複数ファイルを
続けて検索したい場合は、FindNextFile関数を使用します。


【式】

    HANDLE FindFirstFile(LPCTSTR lpPathName,
                         LPWIN32_FIND_DATA lpFindFileData);

【引数】

    lpPathName :
        作成または開くオブジェクト名

    lpFindFileData :
        (WIN32_FIND_DATA構造体へのポインタ)
        見つかったファイルの情報が格納される


【戻り値】

    成功 : オブジェクトのハンドル
    失敗 : INVALID_HANDLE_VALUE


【サンプル】

//FindFirstFileを使用したファイルの検索
void CFindFirstFileDlg::OnButton1() 
{
    HANDLE hFind;
    WIN32_FIND_DATA FileData;
    CString FName;

    FName = "C:\\temp\\test.txt";

    //ファイルの検索
    hFind = FindFirstFile(FName, &FileData);

    if(hFind == INVALID_HANDLE_VALUE){
        AfxMessageBox("ファイルを発見できませんでした");
    }
    else{
        AfxMessageBox("ファイルを発見しました");
    }

    FindClose(hFind);
}


[サンプル・プロジェクト]


(注意)
このサンプルは、Visual C++ 6.0で作成されています。
また、詳細に付いてはMSDNを参照して下さい。