VB声明

说明

返回值

参数表

注解(其他 VC声明)

参数详解(返回值：)

VB声明

Declare Function MapViewOfFile& Lib "kernel32" (ByVal hFileMappingObject As Long, ByVal dwDesiredAccess As Long, ByVal dwFileOffsetHigh As Long, ByVal dwFileOffsetLow As Long, ByVal dwNumberOfBytesToMap As Long)

Declare Function MapViewOfFileEx& Lib "kernel32" (ByVal hFileMappingObject As Long, ByVal dwDesiredAccess As Long, ByVal dwFileOffsetHigh As Long, ByVal dwFileOffsetLow As Long, ByVal dwNumberOfBytesToMap As Long, lpBaseAddress As Any)

说明

将一个文件映射对象映射到当前应用程序的地址空间。MapViewOfFileEx允许我们指定一个基本地址来进行映射。

返回值

Long，文件映射在内存中的起始地址。零表示出错。会设置GetLastError

参数表

hFileMappingObject Long，文件映射对象的句柄。

dwDesiredAccess Long，下述常数之一：

FILE_MAP_WRITE 映射可读可写。文件映射对象必须通过PAGE_READWRITE访问创建。

FILE_MAP_READ 映射只读。文件映射对象必须通过PAGE_READ 或 PAGE_READWRITE访问创建。

FILE_MAP_ALL_ACCESS 与FILE_MAP_WRITE相同。

FILE_MAP_COPY 映射时保留写操作的副本。文件映射对象必须用PAGE_WRITECOPY访问在win95下创建

dwFileOffsetHigh Long，文件中映射起点的高32位地址。

dwFileOffsetLow Long，文件中映射起点的低32位地址。

dwNumberOfBytesToMap Long，文件中要映射的字节数。用零映射整个文件映射对象。

lpBaseAddress Long，指定映射文件映射对象的地址。如这个地址处没有足够的内存空间，那么对MapViewOfFileEx的调用会失效。零表示允许windows寻找一个地址。

注解

dwFileOffsetLow和dwFileOffsetHigh必须反映一个偏移距离，它由系统的内存分配精度决定。例如，假设系统的内存精度是64KB（即最小分配单位是64KB），则这些值必须是64KB的整数倍。大多数应用程序都简单的用零从文件的起始处开始映射。lpBaseAddress也必须是内存分配精度的整数倍

其他

声明中的参数类型为Any，而参数表中都是Long，我也不明白。但关于这个函数的英文资料的确是这样的。

VC声明

Maps a view of a file mapping into the address space of a calling process.

LPVOID WINAPI MapViewOfFile(

__in HANDLE hFileMappingObject,

__in DWORD dwDesiredAccess,

__in DWORD dwFileOffsetHigh,

__in DWORD dwFileOffsetLow,

__in SIZE_T dwNumberOfBytesToMap

);

参数详解

hFileMappingObject 为CreateFileMapping()返回的文件映像对象句柄。

dwDesiredAccess 映射对象的文件数据的访问方式，而且同样要与CreateFileMapping()函数所设置的保护属性相匹配。 可取以下值：

FILE_MAP_ALL_ACCESS 等价于CreateFileMapping的 FILE_MAP_WRITE|FILE_MAP_READ. 文件映射对象被创建时必须指定PAGE_READWRITE 选项.

FILE_MAP_COPYA 可以读取和写入文件.写入操作会导致系统为该页面创建一份副本.在调用CreateFileMapping时必须传入PAGE_WRITECOPY保护属性.

FILE_MAP_EXECUTE 可以将文件中的数据作为代码来执行.在调用CreateFileMapping时可以传入PAGE_EXECUTE_READWRITE或PAGE_EXECUTE_READ保护属性.

FILE_MAP_READ 可以读取文件.在调用CreateFileMapping时可以传入PAGE_READONLY或PAGE_READWRITE保护属性.

FILE_MAP_WRITEA 可以读取和写入文件.在调用CreateFileMapping时必须传入PAGE_READWRITE保护属性.

dwFileOffsetHigh 表示文件映射起始偏移的高32位.

dwFileOffsetLow 表示文件映射起始偏移的低32位.文件偏移量必须是系统分配粒度的整数倍.

dwNumberOfBytes 指定映射文件的字节数.

返回值：

如果成功,则返回映射视图文件的开始地址值。

如果失败，则返回 NULL.可调用GetLastError（）查看错误。