Функция OpenFileById (winbase.h)

Открывает файл, соответствующий указанному идентификатору.

Синтаксис

HANDLE OpenFileById(
  [in]           HANDLE                hVolumeHint,
  [in]           LPFILE_ID_DESCRIPTOR  lpFileId,
  [in]           DWORD                 dwDesiredAccess,
  [in]           DWORD                 dwShareMode,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [in]           DWORD                 dwFlagsAndAttributes
);

Параметры

[in] hVolumeHint

Дескриптор любого файла в томе или общей папке, в которой хранится файл, который должен быть открыт.

[in] lpFileId

Указатель на FILE_ID_DESCRIPTOR , определяющий открываемую папку.

[in] dwDesiredAccess

Доступ к объекту . Доступ может быть для чтения, записи или и того, и другого.

Дополнительные сведения см. в разделе Безопасность файлов и права доступа. Нельзя запросить режим доступа, который конфликтует с режимом общего доступа, указанным в открытом запросе с открытым дескриптором.

Если этот параметр равен нулю (0), приложение может запрашивать атрибуты файла и устройства без доступа к устройству. Это полезно для приложения, чтобы определить размер дисковода гибких дисков и поддерживаемые им форматы без необходимости использовать гибкие диски на диске. Его также можно использовать для проверки существования файла или каталога, не открывая их для чтения или записи.

[in] dwShareMode

Режим совместного использования объекта, который может быть считывается, записывается, как, так и нет.

Нельзя запросить режим общего доступа, конфликтующий с режимом доступа, указанным в открытом запросе с открытым дескриптором, так как это приведет к следующему нарушению общего доступа: (ERROR_SHARING_VIOLATION). Дополнительные сведения см. в разделе Создание и открытие файлов.

Если этот параметр равен нулю (0) и OpenFileById выполняется успешно, объект не может быть общим и не может быть открыт снова, пока не будет закрыт дескриптор. Дополнительные сведения см. в разделе Примечания этого раздела.

Параметры общего доступа остаются в силе, пока вы не закроете дескриптор для объекта.

Чтобы позволить процессам совместно использовать объект, в то время как объект открыт другим процессом, используйте сочетание одного или нескольких из следующих значений, чтобы указать режим доступа, который они могут запрашивать для открытия объекта.

[in, optional] lpSecurityAttributes

Зарезервировано.

[in] dwFlagsAndAttributes

Флаги файла.

Когда OpenFileById открывает файл, он объединяет флаги файла с существующими атрибутами файла и игнорирует все предоставленные атрибуты файла. Этот параметр может включать любое сочетание следующих флагов.

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

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

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

Комментарии

Используйте функцию CloseHandle для закрытия дескриптора объекта, возвращаемого OpenFileById .

При вызове OpenFileById для файла, ожидающего удаления в результате предыдущего вызова DeleteFile, функция завершается ошибкой. Операционная система задерживает удаление файла, пока не будут закрыты все дескрипторы файла. GetLastError возвращает ERROR_ACCESS_DENIED.

В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.

Требования

См. также раздел

ACCESS_MASK

CloseHandle

CreateFile

DeleteFile

FILE_ID_DESCRIPTOR

Функции управления файлами

GetFileInformationByHandleEx

GetOverlappedResult

ПЕРЕКРЫВАЮЩИХСЯ

OpenFile

ReadFile

WriteFile