CreateFileMapping函数[通俗易懂]

为指定文件创建或打开命名或未命名的文件映射对象。要为物理内存指定NUMA节点,请参阅CreateFileMappingNuma。语法HANDLEWINAPICreateFileMapping(_In_HANDLEhFile,_In_opt_LPSECURITY_ATTRIBUTESlpAttributes,_In_DWORDflProtect,…

大家好,又见面了,我是你们的朋友全栈君。

为指定文件创建或打开命名或未命名的文件映射对象。

要为物理内存指定NUMA节点,请参阅CreateFileMappingNuma。

语法

HANDLE WINAPI CreateFileMapping(
  _In_ HANDLE hFile,
  _In_opt_ LPSECURITY_ATTRIBUTES lpAttributes,
  _In_ DWORD flProtect,
  _In_ DWORD dwMaximumSizeHigh,
  _In_ DWORD dwMaximumSizeLow,
  _In_opt_ LPCTSTR lpName
);

参数
hFile [in]
从中创建文件映射对象的文件句柄。

必须使用与flProtect参数指定的保护标志兼容的访问权限打开该文件。它不是必需的,但建议打开要映射的文件以进行独占访问。有关更多信息,请参阅文件安全性和访问权限。

如果hFile为INVALID_HANDLE_VALUE,则调用进程还必须在dwMaximumSizeHigh和dwMaximumSizeLow参数中指定文件映射对象的大小。在此方案中,CreateFileMapping创建指定大小的文件映射对象,该对象由系统页面文件而不是文件系统中的文件支持。

lpAttributes [in,optional]
指向SECURITY_ATTRIBUTES结构的指针,该结构确定子进程是否可以继承返回的句柄。 SECURITY_ATTRIBUTES结构的lpSecurityDescriptor成员为新文件映射对象指定安全描述符。

如果lpAttributes为NULL,则无法继承句柄,文件映射对象将获取默认安全描述符。文件映射对象的默认安全描述符中的访问控制列表(ACL)来自创建者的主要或模拟令牌。有关更多信息,请参阅文件映射安全性和访问权限。

flProtect [in]
指定文件映射对象的页面保护。对象的所有映射视图必须与此保护兼容。

此参数可以是以下值之一。

含义

PAGE_EXECUTE_READ

0x20

允许将视图映射为只读,写时复制或执行访问。

必须使用GENERIC_READ和GENERIC_EXECUTE访问权限创建hFile参数指定的文件句柄。Windows Server 2003和Windows XP:在带有SP1的Windows XP和带有SP1的Windows Server 2003之前,此值不可用。

PAGE_EXECUTE_READWRITE

0x40

允许将视图映射为只读,写时复制,读/写或执行访问。

必须使用GENERIC_READ,GENERIC_WRITE和GENERIC_EXECUTE访问权限创建hFile参数指定的文件句柄。

Windows Server 2003和Windows XP:在带有SP1的Windows XP和带有SP1的Windows Server 2003之前,此值不可用。

PAGE_EXECUTE_WRITECOPY

0x80

允许将视图映射为只读,写时复制或执行访问。该值等于PAGE_EXECUTE_READ。

必须使用GENERIC_READ和GENERIC_EXECUTE访问权限创建hFile参数指定的文件句柄。

Windows Vista:在Windows Vista SP1之前,此值不可用。
Windows Server 2003和Windows XP:不支持此值。

PAGE_READONLY

0x02

允许映射视图以进行只读或写时复制访问。尝试写入特定区域会导致访问冲突。

必须使用GENERIC_READ访问权限创建hFile参数指定的文件句柄。

PAGE_READWRITE

0x04

允许映射视图以进行只读,写时复制或读/写访问。

必须使用GENERIC_READ和GENERIC_WRITE访问权限创建hFile参数指定的文件句柄。

PAGE_WRITECOPY

0x08

允许映射视图以进行只读或写时复制访问。该值相当于PAGE_READONLY。

必须使用GENERIC_READ访问权限创建hFile参数指定的文件句柄。

应用程序可以通过将它们与前面的页面保护值之一组合来为文件映射对象指定以下一个或多个属性。

 

Value Meaning

SEC_COMMIT

0x8000000

如果文件映射对象由操作系统页面文件(hfile参数为INVALID_HANDLE_VALUE)支持,则指定当文件视图映射到进程地址空间时,将提交整个页面范围而不是保留。系统必须具有足够的可提交页面来保存整个映射。否则,CreateFileMapping失败。

此属性对可执行映像文件或数据文件支持的文件映射对象没有影响(hfile参数是文件的句柄)。

SEC_COMMIT不能与SEC_RESERVE结合使用。

如果未指定任何属性,则假定为SEC_COMMIT。

SEC_IMAGE

0x1000000

指定hFile参数指定的文件是可执行映像文件。

SEC_IMAGE属性必须与页面保护值(如PAGE_READONLY)结合使用。但是,此页面保护值对可执行映像文件的视图没有影响。可执行文件视图的页面保护由可执行文件本身决定。

SEC_IMAGE没有其他属性有效。

SEC_IMAGE_NO_EXECUTE

0x11000000

指定hFile参数指定的文件是不会执行的可执行映像文件,并且加载的映像文件将不会运行强制完整性检查。此外,映射使用SEC_IMAGE_NO_EXECUTE属性创建的文件映射对象的视图不会调用使用PsSetLoadImageNotifyRoutine内核API注册的驱动程序回调。

SEC_IMAGE_NO_EXECUTE属性必须与PAGE_READONLY页面保护值组合使用。 SEC_IMAGE_NO_EXECUTE没有其他属性有效。

Windows Server 2008 R2,Windows 7,Windows Server 2008,Windows Vista,Windows Server 2003和Windows XP:Windows Server 2012和Windows 8之前不支持此值。

SEC_LARGE_PAGES

0x80000000

允许大页面用于由操作系统页面文件支持的文件映射对象(hfile参数为INVALID_HANDLE_VALUE)。由可执行映像文件或数据文件支持的文件映射对象不支持此属性(hFile参数是可执行映像或数据文件的句柄)。

文件映射对象的最大大小必须是GetLargePageMinimum函数返回的大页面的最小大小的倍数。如果不是,则CreateFileMapping失败。映射使用SEC_LARGE_PAGES创建的文件映射对象的视图时,基址和视图大小也必须是最小大页面大小的倍数。

SEC_LARGE_PAGES需要在调用者令牌中启用SeLockMemoryPrivilege特权。

如果指定了SEC_LARGE_PAGES,则还必须指定SEC_COMMIT。

Windows Server 2003:Windows Server 2003 SP1之前不支持此值。
Windows XP:不支持此值。

SEC_NOCACHE

0x10000000

将所有页面设置为不可缓存。

应用程序不应使用此属性,除非设备明确要求。使用带有SEC_NOCACHE映射的内存的互锁函数可能会导致EXCEPTION_ILLEGAL_INSTRUCTION异常。

SEC_NOCACHE要求设置SEC_RESERVE或SEC_COMMIT属性。

SEC_RESERVE

0x4000000

如果文件映射对象由操作系统页面文件(hfile参数为INVALID_HANDLE_VALUE)支持,则指定当文件视图映射到进程地址空间时,整个页面范围保留供进程以后使用而非承诺。

可以在后续调用VirtualAlloc函数时提交保留页面。提交页面后,无法使用VirtualFree函数释放或取消它们。

此属性对可执行映像文件或数据文件支持的文件映射对象没有影响(hfile参数是文件的句柄)。

SEC_RESERVE不能与SEC_COMMIT结合使用。

SEC_WRITECOMBINE

0x40000000

将所有页面设置为写入组合。

应用程序不应使用此属性,除非设备明确要求。使用带有SEC_WRITECOMBINE映射的内存的互锁函数可能会导致EXCEPTION_ILLEGAL_INSTRUCTION异常。

SEC_WRITECOMBINE需要设置SEC_RESERVE或SEC_COMMIT属性。

Windows Server 2003和Windows XP:Windows Vista之前不支持此标志。

dwMaximumSizeHigh [in]
文件映射对象最大大小的高阶DWORD。

dwMaximumSizeLow [in]
文件映射对象的最大大小的低位DWORD。

如果此参数和dwMaximumSizeHigh为0(零),则文件映射对象的最大大小等于hFile标识的文件的当前大小。

尝试映射长度为0(零)的文件失败,错误代码为ERROR_FILE_INVALID。应用程序应测试长度为0(零)的文件并拒绝这些文件。

lpName [in,optional]
文件映射对象的名称。

如果此参数与现有映射对象的名称匹配,则该函数请求具有flProtect指定的保护的对象的访问权限。

如果此参数为NULL,则创建没有名称的文件映射对象。

如果lpName与现有事件,信号量,互斥锁,等待计时器或作业对象的名称匹配,则该函数将失败,并且GetLastError函数将返回ERROR_INVALID_HANDLE。这是因为这些对象共享相同的命名空间。

该名称可以具有“Global”或“Local”前缀,以在全局或会话命名空间中显式创建对象。名称的其余部分可以包含除反斜杠字符(\)之外的任何字符。从会话零以外的会话在全局命名空间中创建文件映射对象需要SeCreateGlobalPrivilege特权。有关更多信息,请参阅内核对象命名空间。

通过使用终端服务会话实现快速用户切换。第一个登录用户使用会话0(零),下一个登录用户使用会话1(一),依此类推。内核对象名称必须遵循为终端服务概述的准则,以便应用程序可以支持多个用户。

 

返回值
如果函数成功,则返回值是新创建的文件映射对象的句柄。

如果对象在函数调用之前存在,则该函数返回现有对象的句柄(具有当前大小,而不是指定大小),并且GetLastError返回ERROR_ALREADY_EXISTS。

如果函数失败,则返回值为NULL。要获取扩展错误信息,请调用GetLastError。

备注
创建文件映射对象后,文件大小不得超过文件映射对象的大小;如果是,则并非所有文件内容都可用于共享。

如果应用程序指定文件映射对象的大小大于磁盘上实际命名文件的大小,并且页面保护允许写访问(即,flProtect参数指定PAGE_READWRITE或PAGE_EXECUTE_READWRITE),则磁盘上的文件增加以匹配文件映射对象的指定大小。如果文件被扩展,则文件旧端与文件新端之间的文件内容不保证为零;行为由文件系统定义。如果磁盘上的文件无法增加,则CreateFileMapping将失败,GetLastError将返回ERROR_DISK_FULL。

由操作系统页面文件支持的文件映射对象中的页面的初始内容是0(零)。

CreateFileMapping返回的句柄具有对新文件映射对象的完全访问权限,并且可以与需要文件映射对象句柄的任何函数一起使用。

多个进程可以通过使用单个共享文件映射对象或创建由同一文件支持的单独文件映射对象来共享同一文件的视图。单个文件映射对象可以由多个进程共享,方法是在创建进程时继承句柄,复制句柄或按名称打开文件映射对象。有关更多信息,请参阅CreateProcess,DuplicateHandle和OpenFileMapping函数。

创建文件映射对象实际上并不将视图映射到进程地址空间。 MapViewOfFile和MapViewOfFileEx函数将文件视图映射到进程地址空间。

有一个重要的例外,从同一文件支持的任何文件映射对象派生的文件视图在特定时间是一致的或相同的。对于进程内的视图和由不同进程映射的视图,可以保证一致性。

该例外与远程文件有关。尽管CreateFileMapping可以与远程文件一起使用,但它并不能保持连贯性。例如,如果两台计算机都将文件映射为可写,并且两者都更改了同一页面,则每台计算机只能看到自己对该页面的写入。当数据在磁盘上更新时,它不会合并。

映射文件和使用输入和输出(I / O)函数(ReadFile和WriteFile)访问的文件不一定是连贯的。

文件映射对象的映射视图维护对象的内部引用,并且文件映射对象在释放对它的所有引用之前不会关闭。因此,要完全关闭文件映射对象,应用程序必须通过调用UnmapViewOfFile取消映射文件映射对象的所有映射视图,并通过调用CloseHandle来关闭文件映射对象句柄。可以按任何顺序调用这些函数。

通过映射视图修改文件时,可能不会自动更新上次修改时间戳。如果需要,调用者应使用SetFileTime设置时间戳。

从会话零以外的会话在全局命名空间中创建文件映射对象需要SeCreateGlobalPrivilege特权。请注意,此权限检查仅限于创建文件映射对象,不适用于打开现有权限。例如,如果服务或系统在全局命名空间中创建文件映射对象,则任何会话中运行的任何进程都可以访问该文件映射对象,前提是调用者具有所需的访问权限。

Windows XP:Windows Server 2003和Windows XP SP2引入了上一段中描述的要求
使用结构化异常处理来保护写入或读取文件视图的任何代码。有关更多信息,请参阅从文件视图中读取和写入。

要使用可执行权限进行映射,应用程序必须使用PAGE_EXECUTE_READWRITE或PAGE_EXECUTE_READ调用CreateFileMapping,然后使用FILE_MAP_EXECUTE调用MapViewOfFile。 FILE_MAP_WRITE或FILE_MAP_EXECUTE | FILE_MAP_READ。

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

发布者:全栈程序员-用户IM,转载请注明出处:https://javaforall.cn/125911.html原文链接:https://javaforall.cn

【正版授权,激活自己账号】: Jetbrains全家桶Ide使用,1年售后保障,每天仅需1毛

【官方授权 正版激活】: 官方授权 正版激活 支持Jetbrains家族下所有IDE 使用个人JB账号...

(0)


相关推荐

  • 怎么从安卓设备转移数据到苹果_如何将数据从安卓手机转移到苹果手机[通俗易懂]

    怎么从安卓设备转移数据到苹果_如何将数据从安卓手机转移到苹果手机[通俗易懂]手机人手一部,更新也特别快,换系统的同时也想保留之前的数据怎么办?如何将数据从安卓手机转移到苹果手机?android手机数据转移到iPhone手机的方法教程在这里为你准备,第一次使用苹果的用户怎样才能将原有android数据迁移到苹果呢?来看如下具体内容!我们都知道在大屏iPhone6和iPhone6Plus智能手机即将上市的前夕,苹果公司发布了一份详细的支持文件,指导Android用户如何…

  • VBoxManage常用命令用法

    VBoxManage常用命令用法VBoxManage命令常用用法系统环境:CentOS6.3x86_64VirtualBox版本:4.2.8VirtualBox扩展版本:4.2.8增加一个新的扩展包VBoxManageextpackinstall<.vbox-extpack>卸载指定扩展包VBoxManageextpackuninstall<name>显示已安装的扩展包VBoxManagelistextpacks移除安装扩展包失败或卸载扩展包失败时可能遗留下来的文件和

  • 2022pycharm激活码【最新永久激活】

    (2022pycharm激活码)最近有小伙伴私信我,问我这边有没有免费的intellijIdea的激活码,然后我将全栈君台教程分享给他了。激活成功之后他一直表示感谢,哈哈~IntelliJ2021最新激活注册码,破解教程可免费永久激活,亲测有效,下面是详细链接哦~https://javaforall.cn/100143.html…

  • vue获取上传文件路径_vue中文件上传及接收「建议收藏」

    vue获取上传文件路径_vue中文件上传及接收「建议收藏」准备:前端:vue环境+axios+elemen-ui后端:node.jsmulter前端代码://引入axiosimportaxiosfrom’axios’;//获取用户信息getUserInfo(){//发送请求获取用户信息getInfo().then(res=>{//接收数据let{data}=res;this.userInfo=data[0…

  • 为什么说Python 是大数据全栈式开发语言

    为什么说Python 是大数据全栈式开发语言欢迎大家访问我的个人网站《刘江的博客和教程》:"www.liujiangblog.com"主要分享Python及Django教程以及相关的博客原文链接http://www

  • Java中.next()和.nextLine()的区别「建议收藏」

    Java中.next()和.nextLine()的区别「建议收藏」nextLine()方法返回的是Enter键之前的所有字符,它是可以得到带空格的字符串的。next()会自动消去有效字符前的空格,只返回输入的字符,不能得到带空格的字符串。(简单点说,next我只要字,nextLine我啥都要)[java] viewplain copypackage test;    import java.util.Scanner;      public class Sub…

发表回复

您的电子邮箱地址不会被公开。

关注全栈程序员社区公众号