CreateFileMapping

函数

CreateFileMapping函数用于创建一个文件映射内核对象。

声明

SECURITY_ATTRIBUTES, ByVal flProtect As Long, ByVal dwMaximumSizeHigh As Long, ByVal dwMaximumSizeLow As Long, ByVal lpName As String) As Long.

说明

创建一个新的文件映射内核对象。

返回值

Long，新建文件映射对象的句柄；零意味着出错。会设置GetLastError。即使函数成功，但倘若返回的句柄属于一个现成的文件映射对象，那么GetLastError也会设置成ERROR_ALREADY_EXISTS。在这种情况下，文件映射的长度就是现有对象的长度，而不是这个函数指定的尺寸。

参数表

hFile:Long，指定欲在其中创建映射的一个文件句柄。0xFFFFFFFF（-1，即INVALID_HANDLE_VALUE）表示在页面文件中创建一个可共享的文件映射。

lpFileMappigAttributes:SECURITY_ATTRIBUTES，它指明返回的句柄是否可以被子进程所继承，指定一个安全对象，在创建文件映射时使用。如果为NULL（用ByVal As Long传递零），表示使用默认安全对象。

flProtect:Long，下述常数之一：

PAGE_READONLY 以只读方式打开映射

PAGE_READWRITE 以可读、可写方式打开映射

PAGE_WRITECOPY 为写操作留下备份

可组合使用下述一个或多个常数：

SEC_COMMIT 为文件映射一个小节中的所有页分配内存

SEC_IMAGE 文件是个可执行文件

SEC_RESERVE 为没有分配实际内存的一个小节保留虚拟内存空间

dwMaximumSizeHigh:Long，文件映射的最大长度的高32位。

dwMaximumSizeLow:Long，文件映射的最大长度的低32位。如这个参数和dwMaximumSizeHigh都是零，就用磁盘文件的实际长度。

lpName:String，指定文件映射对象的名字。如存在这个名字的一个映射，函数就会打开它。用vbNullString可以创建一个无名的文件映射。

调用CreateFileMapping的时候可能会出现的GetLastError的相应错误：

ERROR_FILE_INVALID （错误_文件_无效）如果企图创建一个零长度的文件映射

ERROR_INVALID_HANDLE（错误_无效_处理）内存空间的命名和现有的内存映射，互斥量，信号量，临界区有同名

ERROR_ALREADY_EXISTS （错误或已经存在）表示内存空间命名已经存在

在调用CreateFileMapping( )时，可以用GetLastError( )来检查其返回的错误信息。如果返回值为ERROR_ALREADY_EXISTS，则表示内存映射对象指定名字已经存在。有关其他返回值的意义见MSDN的详细说明。

详细说明

(1) 物理文件句柄

任何可以获得的物理文件句柄，如果你需要创建一个物理文件无关的内存映射也无妨，将它设置成为 0xFFFFFFFF(INVALID_HANDLE_VALUE)就可以了。

如果使用 INVALID_HANDLE_VALUE，也需要设置需要申请的内存空间的大小，无论物理文件句柄参数是否有效，这样 CreateFileMapping 就可以创建一个和物理文件大小无关的内存空间给你，甚至超过实际文件大小，如果你的物理文件有效，而大小参数为0，则返回给你的是一个和物理文件大小一样的内存空间地址范围。返回给你的文件映射地址空间是可以通过复制，集成或者命名得到，初始内容为0。

(2) 保护设置

就是安全设置，不过一般设置NULL就可以了，使用默认的安全配置。在win2k下如果需要进行限制，这是针对那些将内存文件映射共享给整个网络上面的应用进程使用时，可以考虑进行限制。

(3) 高位文件大小

亲们，我想我们的机器都是32位的东东，不可能得到超过32位进程所能寻址的私有32位地址空间，一般还是设置0吧，我没有也不想尝试将它设置超过0的情况。

(4) 低位文件大小

这个还是可以进行设置的，不过为了让其他共享用户知道你申请的文件映射的相关信息，我使用的时候是在获得的地址空间头部添加一个结构化描述信息，记录内存映射的大小，名称等，这样实际申请的空间就比输入的增加了一个头信息结构大小了，我认为这样类似BSTR的方式应该是比较合理的。

(5)共享内存名称

如果为了对内存进行互斥访问，设置了一个互斥句柄，而名称选择和命名共享内存同名，他们使用共同的namespace，会导致错误。

(6) 调用CreateFileMapping的时候GetLastError的对应错误

ERROR_FILE_INVALID 如果企图创建一个零长度的文件映射，应有此报

ERROR_INVALID_HANDLE 如果发现你的命名内存空间和现有的内存映射，互斥量，信号量，临界区同名就麻烦了

ERROR_ALREADY_EXISTS 表示内存空间命名已经存在