Функция OpenFileMapping

Функция OpenFileMapping открывает именованный объект "проецируемый файл".

Синтаксис
HANDLE OpenFileMapping(
  DWORD dwDesiredAccess,  // режим доступа
  BOOL bInheritHandle,    // флажок наследования
  LPCTSTR lpName          // имя объекта
);
Параметры

dwDesiredAccess

[in] Доступ к объекту "проецируемый " файл. Список значений, см. в статье Защита проецируемого в память файла и права доступа.

Windows NT/2000/XP: Этот доступ проверяется в отношении любого дескриптора безопасности целевого объекта "проецируемый  файл".

Windows 95/98/Me: Дескрипторы безопасности объектов "проецируемый файл" не поддерживаются.

bInheritHandle

[in] Если этот параметр - ИСТИНА (TRUE), новый процесс наследует дескриптор. В противном случае, это не делается.

lpName

[in] Указатель на символьную строку, которая дает имя открываемому объекту "проецируемый файл". Если есть открытый дескриптор объекта "проецируемый файл" с таким именем и дескриптор безопасности  "проецируемого " объекта не находится в противоречии с параметром dwDesiredAccess, операция открытия завершается успешно.

Терминальные службы: Название может иметь префикс "Global\"  или "Local\", чтобы явно открывать объект в глобальном или сессионном пространстве имен. Остаточный член имени может содержать любой символ кроме символа обратного слэша (\). Для получения дополнительной информации, см. статью Пространства имен объекта ядра.

Windows XP Home Edition: Быстрое переключение пользователя осуществляется, при помощи использования сеансов Терминальных служб. Первый пользователь, который начнет работу использует сессию 0, следующий пользователь, который начнет работу использует сессию 1 и так далее. Имена объекта ядра должны следовать  руководящим принципам, обозначенным в Терминальных службах так, чтобы приложения могли поддерживать многочисленных пользователей.

Windows 2000: Если Терминальные службы не запущены,  префиксы "Global\" и "Local\" игнорируются. Остаток от имени может содержать любой символ кроме символа обратного слэша (\).

Windows NT 4.0 и раньше: Имя может содержать любой символ кроме символа обратного слэша (\).

Windows 95/98/Me: Имя может содержать любой символ, кроме символа обратного слэша (\). Пустая  строка (" ") - допустимое  имя объекта.

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

Если функция завершается успешно, возвращаемое значение - открытый дескриптор заданного объекта "проецируемый файл".

Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL). Чтобы получить дополнительные сведения об ошибке, вызовите GetLastError.

Замечания

Дескриптор, который возвращает функция OpenFileMapping, может использоваться любой функцией, которая требует дескриптора объекта "проецируемый файл".

Код примера

Пример смотри в статье  Создание именованной совместно используемой памяти.

Смотри также

Обзор Управление файлами, Функции, используемые для отображения файла в память, CreateFileMapping

Размещение и совместимость OpenFileMapping

К

Windows XP

Да 

л

Windows 2000 Professional

Да

и

Windows NT Workstation

Да

е

Windows Me

Да

н

Windows 98

Да

т

Windows 95

Да

 
С

Windows Server 2003

Да

е Windows 2000 Server Да
р Windows NT Server Да
в    
е    
р    

Используемая библиотека

Kernel32.lib

Используемая DLL -
 Заголовочный файл  

- объявлено в

Winbase.h

 - включено в

Windows.h

 Unicode

Реализуется как Unicode и ANSI в версиях Windows NT/2000/XP. А также поддерживает Microsoft Layer for Unicode.

 Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz