Функция FindFirstStreamW перечисляет первый поток в заданном файле или каталоге.
Синтаксис
HANDLE FindFirstStreamW( LPCWSTR lpFileName, STREAM_INFO_LEVELS InfoLevel, LPVOID lpFindStreamData, DWORD dwFlags ); |
Параметры
lpFileName
[in] Указатель на символьную строку с нулем в конце, которая определяет полное квалифицированное имя файла.InfoLevel
[in] Информационный уровень возвращенных данных. Этот параметр является одним из значений в перечислимом типе STREAM_INFO_LEVELS.lpFindStreamData
[out] Указатель в буфер, который получает данные файла. Формат этих данных зависит от значения InfoLevel.dwFlags
Зарезервированный для будущего использования. Этот параметр должен быть нуль.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - дескриптор поиска, который может использоваться при последующих вызовах функции FindNextStreamW.
Если функция завершается ошибкой, возвращаемое значение - INVALID_HANDLE_VALUE. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Функция FindFirstStreamW открывает дескриптор поиска и возвращает информацию о первом потоке в заданном файле или каталоге. Для файлов, это - всегда заданный по умолчанию поток данных ::$DATA. После того, как дескриптор поиска был установлен, используйте его в функции FindNextStreamW, чтобы разыскать другие потоки в заданном файле или каталоге. Когда дескриптор поиска - больше не нужен, он должен быть закрыт, используя функцию FindClose.
Чтобы компилировать приложение, которое использует эту функцию, определите макрос _WIN32_WINNT как 0x0501 или позже. Дополнительную информацию, см. Использование заголовочных файлов Windows.
Смотри также
Обзор Управление файлами, Функции, используемые управлением файлами, FindClose, FindNextStreamW, STREAM_INFO_LEVELS, WIN32_FIND_STREAM_DATA
|
Размещение и совместимость FindFirstStreamW |
||
| К |
Windows XP |
Нет |
| л |
Windows 2000 |
Нет |
| и |
Windows NT |
Нет |
| е |
Windows Me |
Нет |
| н |
Windows 98 |
Нет |
| т |
Windows 95 |
Нет |
| С |
Windows 2003 Server |
Да |
| е |
Windows 2000 Server |
Нет |
| р |
Windows NT Server |
Нет |
| в |
|
|
| е |
|
|
| р |
|
|
|
Используемая библиотека |
Kernel32.lib |
|
| Требуется библиотека | - | |
| Заголовочный файл | ||
|
- объявлено в |
Winbase.h |
|
|
- включено в |
Windows.h |
|
| Unicode |
Реализуется только как версии Unicode. |
|
| Замечания по платформе |
Не имеется |
|