Файловые операции в Windows

Бизюк Андрей

ВГТУ

2024-12-03

Введение

В Windows API (WinAPI) существует множество функций для работы с файлами и каталогами. Ниже приведены некоторые из наиболее распространенных файловых операций, которые можно выполнить с использованием WinAPI в языке программирования C/C++.

1. Создание файла:
   • CreateFile: Эта функция позволяет создавать новые файлы или открывать существующие. Она также позволяет указать параметры доступа, атрибуты и так далее.
2. Чтение файла:
   • ReadFile: Для чтения данных из файла в буфер.
   • SetFilePointer и SetFilePointerEx: Установка указателя файла для чтения с определенной позиции.
3. Запись в файл:
   • WriteFile: Для записи данных в файл.
   • SetEndOfFile: Установка размера файла.
4. Удаление файла:
   • DeleteFile: Для удаления файла.
5. Переименование и перемещение файла:
   • MoveFile и MoveFileEx: Переименование или перемещение файла или каталога.
6. Работа с атрибутами файла:
   • GetFileAttributes и GetFileAttributesEx: Получение атрибутов файла.
   • SetFileAttributes: Установка атрибутов файла.
7. Проверка существования файла:
   • FileExists: Проверка существования файла с использованием FindFirstFile и FindNextFile.
8. Работа с каталогами:
   • CreateDirectory и CreateDirectoryEx: Создание каталогов.
   • RemoveDirectory: Удаление каталогов.
9. Получение информации о файле:
   • GetFileInformationByHandle: Получение информации о файле, такой как размер, дата создания и т. д.
10. Закрытие файла:
    • CloseHandle: Закрытие открытого файла или дескриптора каталога.

Пример кода на C/C++ для открытия файла, чтения из него и закрытия файла с использованием WinAPI:

#include <windows.h>
#include "iostream"

int main() {
    SetConsoleOutputCP(1251);
    // Открыть файл для чтения
    HANDLE hFile = CreateFile("example.txt", GENERIC_READ, 0, NULL, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, NULL);

    if (hFile != INVALID_HANDLE_VALUE) {
        // Чтение данных из файла
        char buffer[1024];
        DWORD bytesRead;
        if (ReadFile(hFile, buffer, sizeof(buffer), &bytesRead, NULL)) {
            // Обработка данных
        }

        // Закрыть файл
        CloseHandle(hFile);
    } else {
        // Обработка ошибки открытия файла
        std::cout << "Не удалось открыть файл" << std::endl;
    }

    return 0;
}

Создание файла

Создание файла в Windows с использованием WinAPI можно выполнить с помощью функции CreateFile. Вот пример на языке C++, который демонстрирует, как создать новый файл:

#include <windows.h>
#include <iostream>

int main() {
    SetConsoleOutputCP(1251);
    LPCSTR fileName = "C:\\путь\\к\\вашему\\файлу\\example.txt"; // Замените путь и имя файла по вашему усмотрению

    // Открыть или создать файл для записи
    HANDLE hFile = CreateFile(fileName, GENERIC_WRITE, 0, NULL, CREATE_NEW, FILE_ATTRIBUTE_NORMAL, NULL);

    if (hFile != INVALID_HANDLE_VALUE) {
        // Файл успешно создан
        std::cout << "Файл '" << fileName << "' успешно создан." << std::endl;

        // Закрыть файл
        CloseHandle(hFile);
    } else {
        // Обработать ошибку
        DWORD error = GetLastError();
        if (error == ERROR_FILE_EXISTS) {
            std::cout << "Файл '" << fileName << "' уже существует." << std::endl;
        } else {
            std::cerr << "Не удалось создать файл '" << fileName << "'. Ошибка " << error << std::endl;
        }
    }

    return 0;
}

В этом примере:

• LPCSTR fileName - это строка, представляющая путь и имя файла. Замените его на желаемый путь и имя файла.
• CreateFile используется для создания файла с заданными параметрами. В данном случае, мы используем CREATE_NEW, чтобы создать новый файл только в том случае, если он не существует.
• Если файл успешно создан, мы выводим сообщение об успехе и затем закрываем файл с помощью CloseHandle.
• Если файл уже существует или возникает другая ошибка, мы выводим соответствующее сообщение.

Функция CreateFile в Windows API имеет множество параметров, которые позволяют настроить операцию создания или открытия файла подробно. Вот общий вид прототипа функции CreateFile:

HANDLE CreateFile(
  LPCTSTR               lpFileName,
  DWORD                 dwDesiredAccess,
  DWORD                 dwShareMode,
  LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  DWORD                 dwCreationDisposition,
  DWORD                 dwFlagsAndAttributes,
  HANDLE                hTemplateFile
);

Давайте рассмотрим каждый параметр более подробно:

1. lpFileName (LPCTSTR):
   • Этот параметр представляет собой путь к файлу или устройству. Он может быть строкой в формате многобайтовых символов (ANSI) или широких символов (Unicode), в зависимости от того, какой тип используется: LPCSTR для ANSI или LPCWSTR для Unicode.
   • Примеры:
     • ANSI: "C:\\example.txt"
     • Unicode: L"C:\\example.txt"
2. dwDesiredAccess (DWORD):
   • Определяет режим доступа к файлу. Это флаги, которые указывают, какие операции можно выполнять с файлом. Например:
     • GENERIC_READ: Разрешает чтение файла.
     • GENERIC_WRITE: Разрешает запись в файл.
   • Вы можете комбинировать флаги с помощью операции побитового ИЛИ (|) для указания нескольких прав доступа.
3. dwShareMode (DWORD):
   • Определяет режим совместного доступа к файлу. Это флаги, указывающие, какие типы доступа можно разрешить другим процессам. Например:
     • FILE_SHARE_READ: Разрешает другим процессам читать файл.
     • FILE_SHARE_WRITE: Разрешает другим процессам записывать в файл.
4. lpSecurityAttributes (LPSECURITY_ATTRIBUTES):
   • Этот параметр позволяет указать атрибуты безопасности для создаваемого файла. Если вы не хотите задавать специальные атрибуты безопасности, можете передать NULL.
5. dwCreationDisposition (DWORD):
   • Определяет, что делать, если файл уже существует или не существует. Некоторые из возможных значений:
     • CREATE_NEW: Создать новый файл (ошибка, если файл уже существует).
     • CREATE_ALWAYS: Создать новый файл или перезаписать существующий.
     • OPEN_EXISTING: Открыть только существующий файл.
     • OPEN_ALWAYS: Открыть существующий файл или создать новый, если его нет.
6. dwFlagsAndAttributes (DWORD):
   • Этот параметр позволяет указать дополнительные атрибуты файла. Например:
     • FILE_ATTRIBUTE_NORMAL: Обычный файл без специальных атрибутов.
     • FILE_ATTRIBUTE_READONLY: Файл только для чтения.
7. hTemplateFile (HANDLE):
   • Этот параметр представляет собой дескриптор файла-шаблона, который используется для определения атрибутов и флагов создаваемого файла. Обычно передается как NULL.

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

Это основные параметры функции CreateFile, но WinAPI предоставляет ещё больше опций для более сложных сценариев работы с файлами, такие как сжатие, шифрование и работа с устройствами. Вам следует обращаться к официальной документации Microsoft для получения более подробной информации и примеров использования этой функции: https://docs.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-createfilea

Чтение файла

Чтение файла в Windows с использованием WinAPI выполняется с помощью функции ReadFile. Эта функция позволяет считывать данные из файла в буфер. Вот пример на языке C++, который демонстрирует, как читать данные из файла:

#include <windows.h>
#include <iostream>

int main() {
    SetConsoleOutputCP(1251);
    LPCSTR fileName = "C:\\путь\\к\\вашему\\файлу\\example.txt"; // Замените путь и имя файла по вашему усмотрению

    // Открыть файл для чтения
    HANDLE hFile = CreateFile(fileName, GENERIC_READ, FILE_SHARE_READ, NULL, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, NULL);

    if (hFile != INVALID_HANDLE_VALUE) {
        char buffer[1024];
        DWORD bytesRead;

        if (ReadFile(hFile, buffer, sizeof(buffer), &bytesRead, NULL)) {
            // Чтение прошло успешно
            if (bytesRead > 0) {
                // Вывести прочитанные данные на экран
                std::cout << "Прочитано " << bytesRead << " байт: " << buffer << std::endl;
            } else {
                std::cout << "Файл пуст." << std::endl;
            }
        } else {
            // Обработать ошибку чтения
            DWORD error = GetLastError();
            std::cerr << "Ошибка чтения файла. Код ошибки: " << error << std::endl;
        }

        // Закрыть файл
        CloseHandle(hFile);
    } else {
        // Обработать ошибку открытия файла
        DWORD error = GetLastError();
        std::cerr << "Не удалось открыть файл. Код ошибки: " << error << std::endl;
    }

    return 0;
}

В этом примере:

• LPCSTR fileName - это строка, представляющая путь и имя файла. Замените его на желаемый путь и имя файла.
• Мы используем CreateFile для открытия файла для чтения с флагом GENERIC_READ.
• Затем мы используем ReadFile для чтения данных из файла в буфер buffer.
• Если чтение прошло успешно, мы выводим прочитанные данные на экран.
• Если возникла ошибка чтения, мы выводим сообщение об ошибке с кодом ошибки.
• Наконец, мы закрываем файл с помощью CloseHandle.

Функция ReadFile в Windows API используется для чтения данных из файла. Вот её прототип:

BOOL ReadFile(
  HANDLE       hFile,
  LPVOID       lpBuffer,
  DWORD        nNumberOfBytesToRead,
  LPDWORD      lpNumberOfBytesRead,
  LPOVERLAPPED lpOverlapped
);

Давайте подробно рассмотрим каждый из параметров:

1. hFile (HANDLE):
   • Это дескриптор файла, который был получен при открытии файла с помощью функции CreateFile. Он указывает на файл, из которого будут читаться данные.
2. lpBuffer (LPVOID):
   • Это указатель на буфер, в который будут считываться данные из файла. Этот буфер должен быть предварительно выделен, и его размер должен быть не меньше, чем nNumberOfBytesToRead, чтобы вместить считанные данные.
3. nNumberOfBytesToRead (DWORD):
   • Этот параметр указывает количество байт, которые нужно прочитать из файла и поместить в буфер lpBuffer.
4. lpNumberOfBytesRead (LPDWORD):
   • Это указатель на переменную, в которую будет записано фактическое количество байт, которые были прочитаны из файла. Эта информация может быть полезной, чтобы узнать, сколько данных было считано.
5. lpOverlapped (LPOVERLAPPED):
   • Этот параметр используется для асинхронного чтения файлов и обычно оставляется равным NULL для синхронного чтения. Если вы хотите выполнять асинхронное чтение, вы можете создать структуру OVERLAPPED и передать указатель на неё.

После вызова функции ReadFile, она возвращает TRUE, если чтение было успешным, и FALSE, если произошла ошибка. Если чтение было успешным, данные будут доступны в буфере lpBuffer, и количество считанных байт будет записано в переменную, на которую указывает lpNumberOfBytesRead.

Запись в файл

Запись данных в файл в Windows с использованием WinAPI выполняется с помощью функции WriteFile. Эта функция позволяет записать данные из буфера в файл. Вот её прототип:

BOOL WriteFile(
  HANDLE       hFile,
  LPCVOID      lpBuffer,
  DWORD        nNumberOfBytesToWrite,
  LPDWORD      lpNumberOfBytesWritten,
  LPOVERLAPPED lpOverlapped
);

Давайте подробно рассмотрим каждый из параметров:

1. hFile (HANDLE):
   • Это дескриптор файла, который был получен при открытии файла с помощью функции CreateFile. Он указывает на файл, в который будут записываться данные.
2. lpBuffer (LPCVOID):
   • Это указатель на буфер, из которого будут записываться данные в файл. Этот буфер должен содержать данные, которые вы хотите записать.
3. nNumberOfBytesToWrite (DWORD):
   • Этот параметр указывает количество байт, которые нужно записать в файл из буфера lpBuffer.
4. lpNumberOfBytesWritten (LPDWORD):
   • Это указатель на переменную, в которую будет записано фактическое количество байт, которые были успешно записаны в файл. Эта информация может быть полезной, чтобы узнать, сколько данных было записано.
5. lpOverlapped (LPOVERLAPPED):
   • Этот параметр используется для асинхронной записи файлов и обычно оставляется равным NULL для синхронной записи. Если вы хотите выполнять асинхронную запись, вы можете создать структуру OVERLAPPED и передать указатель на неё.

После вызова функции WriteFile, она возвращает TRUE, если запись была успешной, и FALSE, если произошла ошибка. Если запись была успешной, количество фактически записанных байт будет записано в переменную, на которую указывает lpNumberOfBytesWritten.

Вот пример использования функции WriteFile для записи данных в файл:

#include <windows.h>
#include <iostream>

int main() {
    SetConsoleOutputCP(1251);
    LPCSTR fileName = "C:\\путь\\к\\вашему\\файлу\\example.txt"; // Замените путь и имя файла по вашему усмотрению

    // Открыть файл для записи
    HANDLE hFile = CreateFile(fileName, GENERIC_WRITE, 0, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);

    if (hFile != INVALID_HANDLE_VALUE) {
        const char *data = "Пример записи в файл.";
        DWORD bytesWritten;

        if (WriteFile(hFile, data, strlen(data), &bytesWritten, NULL)) {
            // Запись прошла успешно
            std::cout << "Записано " << bytesWritten << " байт." << std::endl;
        } else {
            // Обработать ошибку записи
            DWORD error = GetLastError();
            std::cerr << "Ошибка записи в файл. Код ошибки: " << error << std::endl;
        }

        // Закрыть файл
        CloseHandle(hFile);
    } else {
        // Обработать ошибку открытия файла
        DWORD error = GetLastError();
        std::cerr << "Не удалось открыть/создать файл. Код ошибки: " << error << std::endl;
    }

    return 0;
}

В этом примере мы открываем файл для записи с помощью CreateFile, затем используем WriteFile для записи данных в файл и, наконец, закрываем файл с помощью CloseHandle. После успешной записи мы выводим количество записанных байт.

Удаление файла

Для удаления файла в Windows с использованием WinAPI вы можете использовать функцию DeleteFile. Вот её прототип:

BOOL DeleteFile(
  LPCTSTR lpFileName
);

Давайте рассмотрим параметр этой функции:

1. lpFileName (LPCTSTR):
   • Этот параметр представляет собой строку, содержащую путь к файлу, который вы хотите удалить. Обычно это Unicode-строка, представленная как LPCWSTR для широких символов или LPCTSTR для многобайтовых символов.

Пример использования функции DeleteFile для удаления файла:

#include <windows.h>
#include <iostream>

int main() {
    SetConsoleOutputCP(1251);
    LPCSTR fileName = "C:\\путь\\к\\вашему\\файлу\\example.txt"; // Замените путь и имя файла по вашему усмотрению

    if (DeleteFile(fileName)) {
        std::cout << "Файл '" << fileName << "' успешно удалён." << std::endl;
    } else {
        DWORD error = GetLastError();
        std::cerr << "Не удалось удалить файл '" << fileName << "'. Код ошибки: " << error << std::endl;
    }

    return 0;
}

В этом примере:

• LPCSTR fileName - это строка, представляющая путь и имя файла, который вы хотите удалить. Замените его на путь и имя вашего файла.
• Мы вызываем DeleteFile с указанием имени файла для удаления.
• Если файл успешно удалён, мы выводим сообщение об успехе.
• Если удаление не удалось, мы выводим сообщение об ошибке с кодом ошибки.

Переименование и перемещение

Для переименования и перемещения файла в Windows с использованием WinAPI, вы можете воспользоваться функцией MoveFile или её вариациями. Вот примеры использования:

Переименование файла:

#include <windows.h>
#include <iostream>

int main() {
    SetConsoleOutputCP(1251);
    LPCSTR oldFileName = "C:\\путь\\к\\старому\\файлу\\old_file.txt"; // Замените старый путь и имя файла
    LPCSTR newFileName = "C:\\путь\\к\\новому\\файлу\\new_file.txt"; // Замените новый путь и имя файла

    if (MoveFile(oldFileName, newFileName)) {
        std::cout << "Файл успешно переименован в '" << newFileName << "'." << std::endl;
    } else {
        DWORD error = GetLastError();
        std::cerr << "Не удалось переименовать файл. Код ошибки: " << error << std::endl;
    }

    return 0;
}

В этом примере:

• Мы используем функцию MoveFile для переименования файла или перемещения его в новое место.
• Если операция прошла успешно, выводится сообщение об успехе.
• Если операция не удалась, выводится сообщение об ошибке с кодом ошибки.

Работа с атрибутами файла

Вы можете управлять атрибутами файла в Windows с использованием WinAPI с помощью функций GetFileAttributes и SetFileAttributes. Вот примеры работы с атрибутами файла:

Получение атрибутов файла:

#include <windows.h>
#include <iostream>

int main() {
    SetConsoleOutputCP(1251);
    LPCSTR fileName = "C:\\путь\\к\\вашему\\файлу\\example.txt"; // Замените путь и имя файла по вашему усмотрению

    DWORD fileAttributes = GetFileAttributes(fileName);

    if (fileAttributes != INVALID_FILE_ATTRIBUTES) {
        if (fileAttributes & FILE_ATTRIBUTE_DIRECTORY) {
            std::cout << "Файл '" << fileName << "' - это каталог." << std::endl;
        } else {
            std::cout << "Файл '" << fileName << "' - это обычный файл." << std::endl;
        }

        if (fileAttributes & FILE_ATTRIBUTE_READONLY) {
            std::cout << "Файл '" << fileName << "' доступен только для чтения." << std::endl;
        }
    } else {
        DWORD error = GetLastError();
        std::cerr << "Не удалось получить атрибуты файла. Код ошибки: " << error << std::endl;
    }

    return 0;
}

Установка атрибутов файла:

#include <windows.h>
#include <iostream>

int main() {
    SetConsoleOutputCP(1251);
    LPCSTR fileName = "C:\\путь\\к\\вашему\\файлу\\example.txt"; // Замените путь и имя файла по вашему усмотрению

    // Получить текущие атрибуты файла
    DWORD fileAttributes = GetFileAttributes(fileName);

    if (fileAttributes != INVALID_FILE_ATTRIBUTES) {
        // Установить новые атрибуты (например, сделать файл доступным только для чтения)
        fileAttributes |= FILE_ATTRIBUTE_READONLY;

        if (SetFileAttributes(fileName, fileAttributes)) {
            std::cout << "Атрибуты файла '" << fileName << "' успешно изменены." << std::endl;
        } else {
            DWORD error = GetLastError();
            std::cerr << "Не удалось изменить атрибуты файла. Код ошибки: " << error << std::endl;
        }
    } else {
        DWORD error = GetLastError();
        std::cerr << "Не удалось получить атрибуты файла. Код ошибки: " << error << std::endl;
    }

    return 0;
}

В обоих примерах:

• Мы используем функцию GetFileAttributes, чтобы получить текущие атрибуты файла.
• Затем мы можем изменить атрибуты файла, если это необходимо, например, сделать файл доступным только для чтения с помощью бита FILE_ATTRIBUTE_READONLY.
• Для изменения атрибутов файла мы используем функцию SetFileAttributes.

Помните, что некоторые атрибуты, такие как FILE_ATTRIBUTE_SYSTEM, могут быть изменены только с административными правами. Убедитесь, что ваше приложение имеет соответствующие права доступа к файлу перед изменением его атрибутов.

Проверка существования файла

Для проверки существования файла в Windows с использованием WinAPI вы можете воспользоваться функцией PathFileExists из библиотеки Shlwapi.h или функцией GetFileAttributes и проверкой возвращаемого значения. Вот примеры:

Используя PathFileExists:

Для компиляции примера в Code::Blocks нужно подключить библиотеку в настройках компилятора:

1. Project -> Build options -> Linker settings -> Add

2. Добавить “shlwapi”.

#include <windows.h>
#include <Shlwapi.h> // Для PathFileExists

int main() {
    SetConsoleOutputCP(1251);
    PCSTR fileName = "C:\\путь\\к\\вашему\\файлу\\example.txt"; // Замените путь и имя файла по вашему усмотрению

    if (PathFileExists(fileName)) {
        // Файл существует
        printf("Файл '%s' существует.\n", fileName);
    } else {
        // Файл не существует
        printf("Файл '%s' не существует.\n", fileName);
    }

    return 0;
}

Используя GetFileAttributes:

#include <windows.h>
#include <iostream>

int main() {
    SetConsoleOutputCP(1251);
    LPCSTR fileName = "C:\\путь\\к\\вашему\\файлу\\example.txt"; // Замените путь и имя файла по вашему усмотрению

    DWORD fileAttributes = GetFileAttributes(fileName);

    if (fileAttributes != INVALID_FILE_ATTRIBUTES && !(fileAttributes & FILE_ATTRIBUTE_DIRECTORY)) {
        // Файл существует
        std::cout << "Файл '" << fileName << "' существует." << std::endl;
    } else {
        // Файл не существует или это каталог
        std::cout << "Файл '" << fileName << "' не существует или это каталог." << std::endl;
    }

    return 0;
}

Оба примера позволяют вам проверить существование файла. Первый пример использует функцию PathFileExists, которая является более простой и интуитивно понятной для этой задачи. Второй пример использует GetFileAttributes и проверяет атрибуты файла, чтобы определить его существование. Вы можете выбрать подходящий для вас метод.

Поиск файлов

Для поиска файлов в Windows с использованием WinAPI, вы можете воспользоваться функцией FindFirstFile и её итеративной версией FindNextFile. Эти функции позволяют вам искать файлы по определенным критериям в указанном каталоге. Вот пример поиска файлов:

#include <windows.h>
#include <iostream>

int main() {
    SetConsoleOutputCP(1251);
    LPCSTR searchPath = "C:\\путь\\к\\каталогу\\*.*"; // Замените путь к каталогу по вашему усмотрению

    WIN32_FIND_DATA findFileData;
    HANDLE hFind = FindFirstFile(searchPath, &findFileData);

    if (hFind != INVALID_HANDLE_VALUE) {
        do {
            if (!(findFileData.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY)) {
                // Элемент найден, и это не каталог
                std::cout << "Имя файла: " << findFileData.cFileName << std::endl;
            }
        } while (FindNextFile(hFind, &findFileData) != 0);

        FindClose(hFind); // Закрыть дескриптор поиска
    } else {
        DWORD error = GetLastError();
        std::cerr << "Не удалось выполнить поиск файлов. Код ошибки: " << error << std::endl;
    }

    return 0;
}

В этом примере:

• Мы указываем путь к каталогу и шаблон имени файлов в searchPath. Например, "C:\\путь\\к\\каталогу\\*.*" будет искать все файлы в указанном каталоге.

• Мы используем FindFirstFile для начала поиска файлов. Функция возвращает дескриптор поиска (типа HANDLE).

• Затем мы используем цикл do-while с FindNextFile для итеративного поиска следующих файлов в каталоге. Функция FindNextFile возвращает 0, когда больше файлов для поиска нет.

• В цикле мы проверяем атрибуты найденных элементов, и если элемент не является каталогом (FILE_ATTRIBUTE_DIRECTORY не установлен), то выводим имя файла.

• Наконец, мы закрываем дескриптор поиска с помощью FindClose.

Помните, что при использовании FindFirstFile и FindNextFile нужно следить за максимальной длиной пути и имени файла, чтобы избежать переполнения буфера. Если вам нужно выполнить более сложные запросы поиска, вы можете использовать FindFirstFileEx.

Работа с каталогами

Для работы с каталогами в Windows с использованием WinAPI вы можете использовать функции, такие как CreateDirectory, RemoveDirectory, SetCurrentDirectory, и GetCurrentDirectory. Вот примеры работы с каталогами:

Создание каталога:

#include <windows.h>
#include <iostream>

int main() {
    SetConsoleOutputCP(1251);
    LPCSTR directoryName = "C:\\путь\\к\\новому\\каталогу"; // Замените путь и имя каталога по вашему усмотрению

    if (CreateDirectory(directoryName, NULL)) {
        std::cout << "Каталог '" << directoryName << "' успешно создан." << std::endl;
    } else {
        DWORD error = GetLastError();
        if (error == ERROR_ALREADY_EXISTS) {
            std::cerr << "Каталог '" << directoryName << "' уже существует." << std::endl;
        } else {
            std::cerr << "Не удалось создать каталог. Код ошибки: " << error << std::endl;
        }
    }

    return 0;
}

Удаление каталога:

#include <windows.h>
#include <iostream>

int main() {
    SetConsoleOutputCP(1251);
    LPCSTR directoryName = "C:\\путь\\к\\каталогу\\для_удаления"; // Замените путь и имя каталога по вашему усмотрению

    if (RemoveDirectory(directoryName)) {
        std::cout << "Каталог '" << directoryName << "' успешно удалён." << std::endl;
    } else {
        DWORD error = GetLastError();
        std::cerr << "Не удалось удалить каталог. Код ошибки: " << error << std::endl;
    }

    return 0;
}

Установка текущего каталога:

#include <windows.h>
#include <iostream>

int main() {
    SetConsoleOutputCP(1251);
    LPCSTR newDirectory = "C:\\путь\\к\\новому\\каталогу"; // Замените путь и имя каталога по вашему усмотрению

    if (SetCurrentDirectory(newDirectory)) {
        std::cout << "Текущий каталог установлен в '" << newDirectory << "'." << std::endl;
    } else {
        DWORD error = GetLastError();
        std::cerr << "Не удалось установить текущий каталог. Код ошибки: " << error << std::endl;
    }

    return 0;
}

Получение текущего каталога:

#include <windows.h>
#include <iostream>

int main() {
    SetConsoleOutputCP(1251);
    CHAR currentDirectory[MAX_PATH];

    if (GetCurrentDirectory(MAX_PATH, currentDirectory) != 0) {
        std::cout << "Текущий каталог: " << currentDirectory << std::endl;
    } else {
        DWORD error = GetLastError();
        std::cerr << "Не удалось получить текущий каталог. Код ошибки: " << error << std::endl;
    }

    return 0;
}

Функции CreateDirectory и RemoveDirectory могут возвращать ошибку ERROR_ALREADY_EXISTS, если каталог уже существует.

Получение информации о файле

Функция GetFileInformationByHandle предоставляет информацию о файле на основе его дескриптора. Эта функция предоставляет подробные сведения о файле, такие как размер, атрибуты, времена создания и др. Вот пример использования функции GetFileInformationByHandle:

#include <windows.h>
#include <iostream>
#include <ctime>

int main() {
    SetConsoleOutputCP(1251);
    LPCSTR fileName = "C:\\путь\\к\\вашему\\файлу\\example.txt"; // Замените путь и имя файла по вашему усмотрению

    // Открыть файл для получения дескриптора
    HANDLE hFile = CreateFile(fileName, GENERIC_READ, FILE_SHARE_READ, NULL, OPEN_EXISTING, 0, NULL);

    if (hFile != INVALID_HANDLE_VALUE) {
        BY_HANDLE_FILE_INFORMATION fileInfo;
        if (GetFileInformationByHandle(hFile, &fileInfo)) {
            std::cout << "Имя файла: " << fileName << std::endl;
            std::cout << "Размер файла: " << fileInfo.nFileSizeLow << " байт" << std::endl;
            std::cout << "Атрибуты файла: " << fileInfo.dwFileAttributes << std::endl;

            SYSTEMTIME sysTime;
            FileTimeToSystemTime(&fileInfo.ftCreationTime, &sysTime);
            std::cout << "Дата создания: " << sysTime.wDay << "." << sysTime.wMonth << "." << sysTime.wYear 
                << " " << sysTime.wHour << ":" << sysTime.wMinute << ":" << sysTime.wSecond << std::endl;

            FileTimeToSystemTime(&fileInfo.ftLastAccessTime, &sysTime);
            std::cout << "Последний доступ: " << sysTime.wDay << "." << sysTime.wMonth << "." << sysTime.wYear 
                << " " << sysTime.wHour << ":" << sysTime.wMinute << ":" << sysTime.wSecond << std::endl;

            FileTimeToSystemTime(&fileInfo.ftLastWriteTime, &sysTime);
            std::cout << "Последнее изменение: " << sysTime.wDay << "." << sysTime.wMonth << "." 
                << sysTime.wYear << " " << sysTime.wHour << ":" << sysTime.wMinute << ":" << sysTime.wSecond << std::endl;
        } else {
            DWORD error = GetLastError();
            std::cerr << "Не удалось получить информацию о файле. Код ошибки: " << error << std::endl;
        }

        // Закрыть дескриптор файла
        CloseHandle(hFile);
    } else {
        DWORD error = GetLastError();
        std::cerr << "Не удалось открыть файл. Код ошибки: " << error << std::endl;
    }

    return 0;
}

В этом примере:

1. Мы открываем файл с помощью функции CreateFile, чтобы получить дескриптор файла (hFile).

2. Затем мы используем GetFileInformationByHandle, передавая ей дескриптор файла и указатель на структуру BY_HANDLE_FILE_INFORMATION, в которую будет записана информация о файле.

3. Мы выводим полученную информацию о файле, такую как имя, размер, атрибуты и времена.

4. После использования дескриптора файла мы его закрываем с помощью CloseHandle.

Обратите внимание, что GetFileInformationByHandle предоставляет более полную информацию о файле, чем GetFileAttributes или GetFileAttributesEx.

Закрытие файла

Для закрытия файла в Windows с использованием WinAPI, вы можете использовать функцию CloseHandle, передав в неё дескриптор файла, который был получен при его открытии с помощью функции CreateFile или других функций, возвращающих дескриптор файла. Вот пример закрытия файла:

#include <windows.h>
#include <iostream>

int main() {
    SetConsoleOutputCP(1251);
    LPCSTR fileName = "C:\\путь\\к\\вашему\\файлу\\example.txt"; // Замените путь и имя файла по вашему усмотрению

    // Открыть файл для чтения
    HANDLE hFile = CreateFile(fileName, GENERIC_READ, FILE_SHARE_READ, NULL, OPEN_EXISTING, 0, NULL);

    if (hFile != INVALID_HANDLE_VALUE) {
        // Выполняйте операции с файлом

        // Закрыть дескриптор файла
        CloseHandle(hFile);
        std::cout << "Файл закрыт." << std::endl;
    } else {
        DWORD error = GetLastError();
        std::cerr << "Не удалось открыть файл. Код ошибки: " << error << std::endl;
    }

    return 0;
}

В этом примере:

1. Мы открываем файл с помощью функции CreateFile, чтобы получить дескриптор файла (hFile).

2. Затем выполняем операции с файлом, если это необходимо.

3. После завершения работы с файлом мы закрываем дескриптор файла с помощью функции CloseHandle.

Закрытие дескриптора файла важно, чтобы освободить ресурсы и предотвратить утечку дескрипторов. Вы должны закрывать дескрипторы файлов после их использования.

Работа с различными системными объектами

Функция CreateFile в Windows может работать с различными типами объектов, такими как файлы, устройства, каталоги и т. д. Вот некоторые из типов объектов, с которыми CreateFile может работать:

1. Файлы: Это наиболее распространенный тип объектов. Вы можете открывать и создавать обычные файлы разных форматов, такие как текстовые, бинарные, конфигурационные и т. д.

2. Устройства: Функция CreateFile может быть использована для работы с системными устройствами, такими как диски, порты COM, принтеры, звуковые устройства и другие. Для этого необходимо указать путь к устройству, например, \\.\COM1 для открытия COM1 порта.

3. Каталоги: С помощью CreateFile можно открывать каталоги и выполнять операции с их содержимым, такие как чтение и запись файлов внутри каталога.

4. Специальные объекты: Это может включать объекты, такие как метки томов, события, мьютексы, семафоры и другие системные ресурсы. Для доступа к ним также используется CreateFile.

5. Пайпы (каналы): Функция CreateFile может использоваться для открытия и взаимодействия с именованными и анонимными каналами, которые предоставляют механизмы межпроцессного взаимодействия (IPC).

6. Mailslots: Mailslots - это еще один механизм IPC, и CreateFile может использоваться для создания или открытия именованных mailslots для передачи сообщений между процессами.

7. Реестр: С помощью CreateFile можно работать с реестром Windows, например, открывать ключи реестра и выполнять операции с данными в них.

8. Потоки ввода-вывода (I/O streams): CreateFile может быть использован для создания и открытия потоков ввода-вывода для работы с консольным вводом-выводом.

Важно отметить, что для каждого типа объекта существуют разные флаги и параметры, которые нужно указать при вызове CreateFile, чтобы правильно работать с этими объектами. Кроме того, различные типы объектов могут подразумевать разные операции ввода-вывода и методы взаимодействия.