-
CreateFileMapping
鎖定
CreateFileMapping函數用於創建一個文件映射內核對象。
- 中文名
- CreateFileMapping
- 頭文件
- Winbase.h
- 創 建
- 新的文件映射內核對象
- Function
- CreateFileMapping
- ByVal
- SECURITY_ATTRIBUTES
CreateFileMapping聲明
Declare Function CreateFileMapping Lib "kernel32" Alias "CreateFileMappingA" (ByVal hFile As Long, lpFileMappigAttributes As SECURITY_ATTRIBUTES, ByVal flProtect As Long, ByVal dwMaximumSizeHigh As Long, ByVal dwMaximumSizeLow As Long, ByVal lpName As String) As Long.
HANDLE WINAPI CreateFileMapping( _In_HANDLE hFile, _In_opt_LPSECURITY_ATTRIBUTES lpAttributes, _In_DWORD flProtect, _In_DWORD dwMaximumSizeHigh, _In_DWORD dwMaximumSizeLow, _In_opt_LPCTSTR lpName);
CreateFileMapping説明
創建一個新的文件映射內核對象。
CreateFileMapping返回值
Long，新建文件映射對象的句柄；零意味着出錯。會設置GetLastError。即使函數成功，但倘若返回的句柄屬於一個現成的文件映射對象，那麼GetLastError也會設置成ERROR_ALREADY_EXISTS。在這種情況下，文件映射的長度就是現有對象的長度，而不是這個函數指定的尺寸。
CreateFileMapping參數表
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_ALREADY_EXISTS （錯誤或已經存在）表示內存空間命名已經存在
在調用CreateFileMapping( )時，可以用GetLastError( )來檢查其返回的錯誤信息。如果返回值為ERROR_ALREADY_EXISTS，則表示內存映射對象指定名字已經存在。有關其他返回值的意義見MSDN的詳細説明。
CreateFileMapping詳細説明
HANDLE CreateFileMapping( HANDLE hFile, //物理文件句柄 LPSECURITY_ATTRIBUTES lpAttributes, //安全設置 DWORD flProtect, //保護設置 DWORD dwMaximumSizeHigh, //高位文件大小 DWORD dwMaximumSizeLow, //低位文件大小 LPCTSTR lpName //共享內存名稱 );
(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 表示內存空間命名已經存在
(7) 相關服務或者平台的命名保留Terminal Services:
命名可以包含 "Global" 或者 "Local" 前綴在全局或者會話名空間初級文件映射。 其他部分可以包含任何除了( )以外的字符， 可以參考 Kernel Object Name Spaces。
- 詞條統計
-
- 瀏覽次數：次
- 編輯次數：27次歷史版本
- 最近更新： 亡命听