На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

FindFirstFile



The FindFirstFile function searches a directory for a file whose name matches the specified filename. FindFirstFile examines subdirectory names as well as filenames.

HANDLE FindFirstFile(

LPCTSTR lpFileName, // pointer to name of file to search for
LPWIN32_FIND_DATA lpFindFileData // pointer to returned information
);


Parameters

lpFileName

Windows 95: Points to a null-terminated string that specifies a valid directory or path and filename, which can contain wildcard characters (* and ?). This string must not exceed MAX_PATH characters.
Windows NT: Points to a null-terminated string that specifies a valid directory or path and filename, which can contain wildcard characters (* and ?).
There is a default string size limit for paths of MAX_PATH characters. This limit is related to how the FindFirstFile function parses paths. An application can transcend this limit and send in paths longer than MAX_PATH characters by calling the wide (W) version of FindFirstFile and prepending "\\?\" to the path. The "\\?\" tells the function to turn off path parsing; it lets paths longer than MAX_PATH be used with FindFirstFileW. This also works with UNC names. The "\\?\" is ignored as part of the path. For example, "\\?\C:\myworld\private" is seen as "C:\myworld\private", and "\\?\UNC\bill_g_1\hotstuff\coolapps" is seen as "\\bill_g_1\hotstuff\coolapps".

lpFindFileData

Points to the WIN32_FIND_DATA structure that receives information about the found file or subdirectory. The structure can be used in subsequent calls to the FindNextFile or FindClose function to refer to the file or subdirectory.



Return Values

If the function succeeds, the return value is a search handle used in a subsequent call to FindNextFile or FindClose.
If the function fails, the return value is INVALID_HANDLE_VALUE. To get extended error information, call GetLastError.

Remarks

The FindFirstFile function opens a search handle and returns information about the first file whose name matches the specified pattern. Once the search handle is established, you can use the FindNextFile function to search for other files that match the same pattern. When the search handle is no longer needed, close it by using the FindClose function.
This function searches for files by name only; it cannot be used for attribute-based searches.

See Also

FindClose, FindNextFile, GetFileAttributes, SetFileAttributes, WIN32_FIND_DATA


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

FindFirstFile



Функция FindFirstFile ищет директорий для файла чьи спички имени определенный filename. FindFirstFile ИЗУЧАЕТ subdirectory имена, а также filenames.

РУЧКА FindFirstFile(

LPCTSTR lpFileName, // УКАЗАТЕЛЬ в имя файла, чтобы искать указатель LPWIN32_FIND_DATA lpFindFileData // на возвращавшее информацию
);


Параметры

lpFileName

Windows 95: Точки на недействительный расторгнутую строку, которые определяют правильный директорий или путь и filename, который может содержать символы шаблона (* и?). Эта строка не должна превышать символы MAX_PATH.
Windows NT: Точки на недействительный расторгнутую строку, которые определяют правильный директорий или путь и filename, который может содержать символы шаблона (* и?).
Есть предел размера по умолчанию строки для путей символов MAX_PATH. Этот предел обусловливается, чтобы как функциональные пути грамматических разборов FindFirstFile. Приложение может превзойти этот предел и посылаться в пути более длинные чем символы MAX_PATH вызывая широкую версию (W) FindFirstFile и добавляя "\\?\" в путь. "\\?\" Сообщает функцию, чтобы выключать синтаксический анализ пути; это позволяет пути дольше чем MAX_PATH использован FindFirstFileW. Это также работает с именами UNC. "\\?\" Проигнорирован как часть пути. Например, "\\?\C:\myworld\private" виден как "C:\myworld\private", и "\\?\UNC\bill_g_1\hotstuff\coolapps" виден как "\\bill_g_1\hotstuff\coolapps".

lpFindFileData

Точки на структуру WIN32_FIND_DATA, которые получают информацию об обнаруженном файле или subdirectory. Структура может быть использована на последующих вызовах в FindNextFile или функцию FindClose, чтобы ссылаться на файл или subdirectory.



Обратные Величины

Если функция добивается успеха, обратная величина является ручкой поиска использованной на последующем вызове на FindNextFile или FindClose.
Если функция терпит неудачу, обратная величина - INVALID_HANDLE_VALUE. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Функция FindFirstFile открывает ручку поиска и возвращает информацию о первом файле чье имя соответствует определенному образцу. Как только ручка поиска будет установлена, Вы можете использовать функцию FindNextFile, чтобы искать другие файлы, которые соответствуют тому же образцу. Когда ручка поиска не - больше не нужно, закройте этому используя функцию FindClose.
Эта функция ищет файлы по имени только; не может быть использовано для базирующихся вспомогательных поисков.

Смотри Также

FindClose, FindNextFile, GetFileAttributes, SetFileAttributes, WIN32_FIND_DATA


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz