Home | History | Annotate | Download | only in include
      1 /**
      2  * This file is part of the mingw-w64 runtime package.
      3  * No warranty is given; refer to the file DISCLAIMER within this package.
      4  */
      5 #ifndef _PATCHAPI_H_
      6 #define _PATCHAPI_H_
      7 
      8 #include <_mingw_unicode.h>
      9 
     10 #ifdef __cplusplus
     11 extern "C" {
     12 #endif
     13 
     14 #ifdef IMPORTING_PATCHAPI_DLL
     15 #define PATCHAPI WINAPI __declspec(dllimport)
     16 #else
     17 #define PATCHAPI WINAPI
     18 #endif
     19 
     20 #define PATCH_OPTION_USE_BEST               0x0
     21 #define PATCH_OPTION_USE_LZX_A              0x1
     22 #define PATCH_OPTION_USE_LZX_B              0x2
     23 #define PATCH_OPTION_USE_LZX_BEST           0x3
     24 #define PATCH_OPTION_USE_LZX_LARGE          0x4
     25 
     26 #define PATCH_OPTION_NO_BINDFIX 0x00010000
     27 #define PATCH_OPTION_NO_LOCKFIX 0x00020000
     28 #define PATCH_OPTION_NO_REBASE 0x00040000
     29 #define PATCH_OPTION_FAIL_IF_SAME_FILE 0x00080000
     30 #define PATCH_OPTION_FAIL_IF_BIGGER 0x00100000
     31 #define PATCH_OPTION_NO_CHECKSUM 0x00200000
     32 #define PATCH_OPTION_NO_RESTIMEFIX 0x00400000
     33 #define PATCH_OPTION_NO_TIMESTAMP 0x00800000
     34 #define PATCH_OPTION_SIGNATURE_MD5 0x01000000
     35 #define PATCH_OPTION_INTERLEAVE_FILES 0x40000000
     36 #define PATCH_OPTION_RESERVED1 0x80000000
     37 
     38 #define PATCH_OPTION_VALID_FLAGS 0xc0ff0007
     39 
     40 #define PATCH_SYMBOL_NO_IMAGEHLP 0x00000001
     41 #define PATCH_SYMBOL_NO_FAILURES 0x00000002
     42 #define PATCH_SYMBOL_UNDECORATED_TOO 0x00000004
     43 #define PATCH_SYMBOL_RESERVED1 0x80000000
     44 
     45 #define APPLY_OPTION_FAIL_IF_EXACT 0x00000001
     46 #define APPLY_OPTION_FAIL_IF_CLOSE 0x00000002
     47 #define APPLY_OPTION_TEST_ONLY 0x00000004
     48 #define APPLY_OPTION_VALID_FLAGS 0x00000007
     49 
     50 #define ERROR_PATCH_ENCODE_FAILURE 0xC00E3101
     51 #define ERROR_PATCH_INVALID_OPTIONS 0xC00E3102
     52 #define ERROR_PATCH_SAME_FILE 0xC00E3103
     53 #define ERROR_PATCH_RETAIN_RANGES_DIFFER 0xC00E3104
     54 #define ERROR_PATCH_BIGGER_THAN_COMPRESSED 0xC00E3105
     55 #define ERROR_PATCH_IMAGEHLP_FAILURE 0xC00E3106
     56 
     57 #define ERROR_PATCH_DECODE_FAILURE 0xC00E4101
     58 #define ERROR_PATCH_CORRUPT 0xC00E4102
     59 #define ERROR_PATCH_NEWER_FORMAT 0xC00E4103
     60 #define ERROR_PATCH_WRONG_FILE 0xC00E4104
     61 #define ERROR_PATCH_NOT_NECESSARY 0xC00E4105
     62 #define ERROR_PATCH_NOT_AVAILABLE 0xC00E4106
     63 
     64   typedef WINBOOL (CALLBACK PATCH_PROGRESS_CALLBACK)(PVOID CallbackContext,ULONG CurrentPosition,ULONG MaximumPosition);
     65   typedef PATCH_PROGRESS_CALLBACK *PPATCH_PROGRESS_CALLBACK;
     66   typedef WINBOOL (CALLBACK PATCH_SYMLOAD_CALLBACK)(ULONG WhichFile,LPCSTR SymbolFileName,ULONG SymType,ULONG SymbolFileCheckSum,ULONG SymbolFileTimeDate,ULONG ImageFileCheckSum,ULONG ImageFileTimeDate,PVOID CallbackContext);
     67   typedef PATCH_SYMLOAD_CALLBACK *PPATCH_SYMLOAD_CALLBACK;
     68 
     69   typedef struct _PATCH_IGNORE_RANGE {
     70     ULONG OffsetInOldFile;
     71     ULONG LengthInBytes;
     72   } PATCH_IGNORE_RANGE,*PPATCH_IGNORE_RANGE;
     73 
     74   typedef struct _PATCH_RETAIN_RANGE {
     75     ULONG OffsetInOldFile;
     76     ULONG LengthInBytes;
     77     ULONG OffsetInNewFile;
     78   } PATCH_RETAIN_RANGE,*PPATCH_RETAIN_RANGE;
     79 
     80   typedef struct _PATCH_OLD_FILE_INFO_A {
     81     ULONG SizeOfThisStruct;
     82     LPCSTR OldFileName;
     83     ULONG IgnoreRangeCount;
     84     PPATCH_IGNORE_RANGE IgnoreRangeArray;
     85     ULONG RetainRangeCount;
     86     PPATCH_RETAIN_RANGE RetainRangeArray;
     87   } PATCH_OLD_FILE_INFO_A,*PPATCH_OLD_FILE_INFO_A;
     88 
     89   typedef struct _PATCH_OLD_FILE_INFO_W {
     90     ULONG SizeOfThisStruct;
     91     LPCWSTR OldFileName;
     92     ULONG IgnoreRangeCount;
     93     PPATCH_IGNORE_RANGE IgnoreRangeArray;
     94     ULONG RetainRangeCount;
     95     PPATCH_RETAIN_RANGE RetainRangeArray;
     96   } PATCH_OLD_FILE_INFO_W,*PPATCH_OLD_FILE_INFO_W;
     97 
     98   typedef struct _PATCH_OLD_FILE_INFO_H {
     99     ULONG SizeOfThisStruct;
    100     HANDLE OldFileHandle;
    101     ULONG IgnoreRangeCount;
    102     PPATCH_IGNORE_RANGE IgnoreRangeArray;
    103     ULONG RetainRangeCount;
    104     PPATCH_RETAIN_RANGE RetainRangeArray;
    105   } PATCH_OLD_FILE_INFO_H,*PPATCH_OLD_FILE_INFO_H;
    106 
    107   typedef struct _PATCH_OLD_FILE_INFO {
    108     ULONG SizeOfThisStruct;
    109     __C89_NAMELESS union {
    110       LPCSTR OldFileNameA;
    111       LPCWSTR OldFileNameW;
    112       HANDLE OldFileHandle;
    113     };
    114     ULONG IgnoreRangeCount;
    115     PPATCH_IGNORE_RANGE IgnoreRangeArray;
    116     ULONG RetainRangeCount;
    117     PPATCH_RETAIN_RANGE RetainRangeArray;
    118   } PATCH_OLD_FILE_INFO,*PPATCH_OLD_FILE_INFO;
    119 
    120   typedef struct _PATCH_INTERLEAVE_MAP {
    121     ULONG CountRanges;
    122     struct {
    123       ULONG OldOffset;
    124       ULONG OldLength;
    125       ULONG NewLength;
    126     } Range[1];
    127   } PATCH_INTERLEAVE_MAP, *PPATCH_INTERLEAVE_MAP;
    128 
    129   typedef struct _PATCH_OPTION_DATA {
    130     ULONG SizeOfThisStruct;
    131     ULONG SymbolOptionFlags;
    132     LPCSTR NewFileSymbolPath;
    133     LPCSTR *OldFileSymbolPathArray;
    134     ULONG ExtendedOptionFlags;
    135     PPATCH_SYMLOAD_CALLBACK SymLoadCallback;
    136     PVOID SymLoadContext;
    137     PPATCH_INTERLEAVE_MAP *InterleaveMapArray;
    138     ULONG MaxLzxWindowSize;
    139   } PATCH_OPTION_DATA,*PPATCH_OPTION_DATA;
    140 
    141   WINBOOL PATCHAPI CreatePatchFileA(LPCSTR OldFileName,LPCSTR NewFileName,LPCSTR PatchFileName,ULONG OptionFlags,PPATCH_OPTION_DATA OptionData);
    142   WINBOOL PATCHAPI CreatePatchFileW(LPCWSTR OldFileName,LPCWSTR NewFileName,LPCWSTR PatchFileName,ULONG OptionFlags,PPATCH_OPTION_DATA OptionData);
    143 #define CreatePatchFile __MINGW_NAME_AW(CreatePatchFile)
    144 
    145   WINBOOL PATCHAPI CreatePatchFileExA(ULONG OldFileCount,PPATCH_OLD_FILE_INFO_A OldFileInfoArray,LPCSTR NewFileName,LPCSTR PatchFileName,ULONG OptionFlags,PPATCH_OPTION_DATA OptionData,PPATCH_PROGRESS_CALLBACK ProgressCallback,PVOID CallbackContext);
    146   WINBOOL PATCHAPI CreatePatchFileExW(ULONG OldFileCount,PPATCH_OLD_FILE_INFO_W OldFileInfoArray,LPCWSTR NewFileName,LPCWSTR PatchFileName,ULONG OptionFlags,PPATCH_OPTION_DATA OptionData,PPATCH_PROGRESS_CALLBACK ProgressCallback,PVOID CallbackContext);
    147 #define CreatePatchFileEx __MINGW_NAME_AW(CreatePatchFileEx)
    148 
    149   WINBOOL PATCHAPI ExtractPatchHeaderToFileA(LPCSTR PatchFileName,LPCSTR PatchHeaderFileName);
    150   WINBOOL PATCHAPI ExtractPatchHeaderToFileW(LPCWSTR PatchFileName,LPCWSTR PatchHeaderFileName);
    151 #define ExtractPatchHeaderToFile __MINGW_NAME_AW(ExtractPatchHeaderToFile)
    152 
    153   WINBOOL PATCHAPI TestApplyPatchToFileA(LPCSTR PatchFileName,LPCSTR OldFileName,ULONG ApplyOptionFlags);
    154   WINBOOL PATCHAPI TestApplyPatchToFileW(LPCWSTR PatchFileName,LPCWSTR OldFileName,ULONG ApplyOptionFlags);
    155 #define TestApplyPatchToFile __MINGW_NAME_AW(TestApplyPatchToFile)
    156 
    157   WINBOOL PATCHAPI ApplyPatchToFileA(LPCSTR PatchFileName,LPCSTR OldFileName,LPCSTR NewFileName,ULONG ApplyOptionFlags);
    158   WINBOOL PATCHAPI ApplyPatchToFileW(LPCWSTR PatchFileName,LPCWSTR OldFileName,LPCWSTR NewFileName,ULONG ApplyOptionFlags);
    159 #define ApplyPatchToFile __MINGW_NAME_AW(ApplyPatchToFile)
    160 
    161   WINBOOL PATCHAPI ApplyPatchToFileExA(LPCSTR PatchFileName,LPCSTR OldFileName,LPCSTR NewFileName,ULONG ApplyOptionFlags,PPATCH_PROGRESS_CALLBACK ProgressCallback,PVOID CallbackContext);
    162   WINBOOL PATCHAPI ApplyPatchToFileExW(LPCWSTR PatchFileName,LPCWSTR OldFileName,LPCWSTR NewFileName,ULONG ApplyOptionFlags,PPATCH_PROGRESS_CALLBACK ProgressCallback,PVOID CallbackContext);
    163 #define ApplyPatchToFileEx __MINGW_NAME_AW(ApplyPatchToFileEx)
    164 
    165   WINBOOL PATCHAPI GetFilePatchSignatureA(LPCSTR FileName,ULONG OptionFlags,PVOID OptionData,ULONG IgnoreRangeCount,PPATCH_IGNORE_RANGE IgnoreRangeArray,ULONG RetainRangeCount,PPATCH_RETAIN_RANGE RetainRangeArray,ULONG SignatureBufferSize,PVOID SignatureBuffer);
    166   WINBOOL PATCHAPI GetFilePatchSignatureW(LPCWSTR FileName,ULONG OptionFlags,PVOID OptionData,ULONG IgnoreRangeCount,PPATCH_IGNORE_RANGE IgnoreRangeArray,ULONG RetainRangeCount,PPATCH_RETAIN_RANGE RetainRangeArray,ULONG SignatureBufferSizeInBytes,PVOID SignatureBuffer);
    167 #define GetFilePatchSignature __MINGW_NAME_AW(GetFilePatchSignature)
    168 
    169   WINBOOL PATCHAPI GetFilePatchSignatureByHandle(HANDLE FileHandle,ULONG OptionFlags,PVOID OptionData,ULONG IgnoreRangeCount,PPATCH_IGNORE_RANGE IgnoreRangeArray,ULONG RetainRangeCount,PPATCH_RETAIN_RANGE RetainRangeArray,ULONG SignatureBufferSize,PVOID SignatureBuffer);
    170   WINBOOL PATCHAPI CreatePatchFileByHandles(HANDLE OldFileHandle,HANDLE NewFileHandle,HANDLE PatchFileHandle,ULONG OptionFlags,PPATCH_OPTION_DATA OptionData);
    171   WINBOOL PATCHAPI CreatePatchFileByHandlesEx(ULONG OldFileCount,PPATCH_OLD_FILE_INFO_H OldFileInfoArray,HANDLE NewFileHandle,HANDLE PatchFileHandle,ULONG OptionFlags,PPATCH_OPTION_DATA OptionData,PPATCH_PROGRESS_CALLBACK ProgressCallback,PVOID CallbackContext);
    172   WINBOOL PATCHAPI ExtractPatchHeaderToFileByHandles(HANDLE PatchFileHandle,HANDLE PatchHeaderFileHandle);
    173   WINBOOL PATCHAPI TestApplyPatchToFileByHandles(HANDLE PatchFileHandle,HANDLE OldFileHandle,ULONG ApplyOptionFlags);
    174   WINBOOL PATCHAPI ApplyPatchToFileByHandles(HANDLE PatchFileHandle,HANDLE OldFileHandle,HANDLE NewFileHandle,ULONG ApplyOptionFlags);
    175   WINBOOL PATCHAPI ApplyPatchToFileByHandlesEx(HANDLE PatchFileHandle,HANDLE OldFileHandle,HANDLE NewFileHandle,ULONG ApplyOptionFlags,PPATCH_PROGRESS_CALLBACK ProgressCallback,PVOID CallbackContext);
    176 
    177 WINBOOL PATCHAPI GetFilePatchSignatureByBuffer(PBYTE FileBufferWritable, ULONG FileSize, ULONG OptionFlags, PVOID OptionData, ULONG IgnoreRangeCount, PPATCH_IGNORE_RANGE IgnoreRangeArray, ULONG RetainRangeCount, PPATCH_RETAIN_RANGE RetainRangeArray, ULONG SignatureBufferSize, LPSTR SignatureBuffer);
    178 WINBOOL PATCHAPI ApplyPatchToFileByBuffers(PBYTE PatchFileMapped, ULONG PatchFileSize, PBYTE OldFileMapped, ULONG OldFileSize, PBYTE *NewFileBuffer, ULONG NewFileBufferSize, ULONG *NewFileActualSize, FILETIME *NewFileTime, ULONG ApplyOptionFlags, PPATCH_PROGRESS_CALLBACK ProgressCallback, PVOID CallbackContext);
    179 WINBOOL PATCHAPI TestApplyPatchToFileByBuffers(PBYTE PatchFileBuffer, ULONG PatchFileSize, PBYTE OldFileBuffer, ULONG OldFileSize, ULONG *NewFileSize, ULONG ApplyOptionFlags);
    180 
    181 #ifdef __cplusplus
    182 }
    183 #endif
    184 #endif
    185