FindFirstStreamW

Поддерживается на Windows Vista

Функция FindFirstStreamW перечисляет первый поток в указанном файле или директории.

HANDLE FindFirstStreamW(
  LPCWSTR lpFileName,
  STREAM_INFO_LEVELS InfoLevel,
  LPVOID lpFindStreamData,
  DWORD dwFlags
);

Параметры:

lpFileName	Адрес нульзаканчивающейся строки, которая определяет полнокачественное имя файла.
InfoLevel	Информационный уровень возвращаемых данных. Этот параметр является одним из значений типа перечисления STREAM_INFO_LEVELS.
lpFindStreamData	Адрес буфера, который получает данные файла. Формат этих данных зависит от значения InfoLevel.
dwFlags	Зарезервировано для будущего использования. Этот параметр должен быть нулевым.

Возвращаемые значения:

Если функция успешна, возвращается дескрипор поиска, который может быть далее воспользован в функции FindNextStreamW.

При ошибке возвращается INVALID_HANDLE_VALUE. Для получения дополнительной информации об ошибке, вызывайте GetLastError.

Замечания:

Функция FindFirstStreamW открывает дескриптор поиска и возвращает информацию о первом потоке в указанном файле или директории. Для файлов, это всегда поток данных по умолчанию, ::$DATA. После того, как дескриптор поиска будет получен, используйте его в функции FindNextStreamW для поиска других потоков в указанном файле или директории. Когда дескриптор поиска больше не нужен, его нужно закрыть с помощью функции FindClose.

При компиляции приложения, которое использует эту функцию, определите макрос _WIN32_WINNT со значением 0x0501 или больше.

Смотрите также:

FindClose, FindNextStreamW, STREAM_INFO_LEVELS, WIN32_FIND_STREAM_DATA