CreateFileMapping函数[通俗易懂]

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

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

要为物理内存指定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]
指定文件映射对象的页面保护。对象的所有映射视图必须与此保护兼容。

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

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。