On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

OpenFileMapping

The OpenFileMapping function opens a named file-mapping object.

HANDLE OpenFileMapping(

DWORD dwDesiredAccess, // access mode
BOOL bInheritHandle, // inherit flag
LPCTSTR lpName // pointer to name of file-mapping object
);

Parameters

dwDesiredAccess

Specifies the access to the file-mapping object.

Windows NT:

This access is checked against any security descriptor on the target file-mapping object.

Windows 95:

Windows 95 does not support security descriptors on file mapping objects.

This parameter can be one of the following values:

Value Meaning
FILE_MAP_WRITE Read-write access. The target file-mapping object must have been created with PAGE_READWRITE protection. A read-write view of the file is mapped.
FILE_MAP_READ Read-only access. The target file-mapping object must have been created with PAGE_READWRITE or PAGE_READ protection. A read-only view of the file is mapped.
FILE_MAP_ALL_ACCESS Same as FILE_MAP_WRITE.
FILE_MAP_COPY Copy-on-write access. The target file-mapping object must have been created with PAGE_WRITECOPY protection. A copy-on-write view of the file is mapped.

bInheritHandle

Specifies whether the returned handle is to be inherited by a new process during process creation. A value of TRUE indicates that the new process inherits the handle.

lpName

Points to a string that names the file-mapping object to be opened. If there is an open handle to a file-mapping object by this name and the security descriptor on the mapping object does not conflict with the dwDesiredAccess parameter, the open operation succeeds.

Return Values

If the function succeeds, the return value is an open handle to the specified file-mapping object.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

The handle that OpenFileMapping returns can be used with any function that requires a handle to a file-mapping object.

See Also

CreateFileMapping

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

OpenFileMapping

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

РУЧКА OpenFileMapping(

DWORD dwDesiredAccess, // СПОСОБ доступа BOOL bInheritHandle, // наследовать указатель флага LPCTSTR lpName // в имя файлового распределения объекта
);

Параметры

dwDesiredAccess

Определяет доступ к файловому распределению объекта.

Окно NT:

Этот доступ сверен с любым дескриптором безопасности в файловом распределении целевого объекта.

Окно 95:

Окно 95 не поддерживает дескрипторы безопасности в файле, отображающем объекты.

Этот параметр может быть одним из следующего величин:

Значение Величины
FILE_MAP_WRITE был Прочитан-доступ записи. Файловое распределение целевого объекта по-видимому создано защитой PAGE_READWRITE. Чтение-запись вида файла отображено.
Только для чтения доступ FILE_MAP_READ. Файловое распределение целевого объекта по-видимому создано PAGE_READWRITE или защитой PAGE_READ. Только для чтения вид файла отображен.
FILE_MAP_ALL_ACCESS Также, как FILE_MAP_WRITE.
Копия-FILE_MAP_COPY в-доступе записи. Файловое распределение целевого объекта по-видимому создано защитой PAGE_WRITECOPY. Копия-в-виде записи файла отображена.

bInheritHandle

Определяет должна возвращанная ручка быть унаследована новым процессом в течение создания процесса. Величина ИСТИНЫ указывает, что новый процесс наследует ручку.

lpName

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

Обратные Величины

Если функция добивается успеха, обратная величина является открытой ручкой в файловое распределение определенного объекта.
Если функция терпит неудачу, обратная величина НЕДЕЙСТВИТЕЛЬНА. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

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

Смотри Также

CreateFileMapping

Используются технологии uCoz