函式功能
該函式返回一個可被UpdateResource函式使用的句柄以便在一個可執行檔案中增加、刪除或替換資源。
函式原型:HANDLE BeginUpdateResource(LPCTSTR pFileName,BOOL bDeleteExistingResources);
相關參數
參數
pFileName:指向一個表示結束的空字元串指針,它是用來指定用以更新資源的基於32-位執行檔的檔案名稱。應用程式必須獲得訪問這個檔案的可寫許可權,並且此檔案在當前狀態下不能被執行。如果pFileName未被指定完全路徑,系統將在當前路徑下搜尋此檔案。
bDeleteExistingResources:說明是否刪除PFileName參數指定的現有資源。如果這個參數為TRUE則現有的資源將被刪除,而更新執行檔只包括由UpdateResource函式增加的資源。如果這個參數為FALSE,則更新的執行檔包括現有的全部資源,除非通過UpdateResource特別說明被刪除或是替換的。
返回值:如果此函式運行成功,其值將通過使用UpdateResource和EndUpdateResource函式返回一個句柄。如果被指定的檔案不是一個執行檔,或者執行檔已被裝載,或者檔案不存在,或是檔案不能被打開寫入時,則返回值為空。若想獲得更多的錯誤信息,請調用GetLastError函式。
速查:Windows 3.1以上。頭檔案:winbase.h:庫檔案:kernel32.lib,Unicode:在Windows NT上實現為Unicode和ANSI兩種版本。