This graph shows which files directly or indirectly include this file:

Classes
struct	_PATCH_IGNORE_RANGE

struct	_PATCH_RETAIN_RANGE

Macros
#define	APPLY_OPTION_FAIL_IF_EXACT 0x00000001

#define	APPLY_OPTION_FAIL_IF_CLOSE 0x00000002

#define	APPLY_OPTION_TEST_ONLY 0x00000004

#define	APPLY_OPTION_VALID_FLAGS 0x00000007

#define	ERROR_PATCH_DECODE_FAILURE 0xC00E4101

#define	ERROR_PATCH_CORRUPT 0xC00E4102

#define	ERROR_PATCH_NEWER_FORMAT 0xC00E4103

#define	ERROR_PATCH_WRONG_FILE 0xC00E4104

#define	ERROR_PATCH_NOT_NECESSARY 0xC00E4105

#define	ERROR_PATCH_NOT_AVAILABLE 0xC00E4106

#define	TestApplyPatchToFile WINELIB_NAME_AW(TestApplyPatchToFile)

#define	ApplyPatchToFile WINELIB_NAME_AW(ApplyPatchToFile)

#define	GetFilePatchSignature WINELIB_NAME_AW(GetFilePatchSignature)

Typedefs
typedef struct _PATCH_IGNORE_RANGE	PATCH_IGNORE_RANGE

typedef struct _PATCH_IGNORE_RANGE *	PPATCH_IGNORE_RANGE

typedef struct _PATCH_RETAIN_RANGE	PATCH_RETAIN_RANGE

typedef struct _PATCH_RETAIN_RANGE *	PPATCH_RETAIN_RANGE

typedef ULONG	CurrentPosition

typedef ULONG ULONG	MaximumPosition

typedef PATCH_PROGRESS_CALLBACK *	PPATCH_PROGRESS_CALLBACK

Functions
typedef	WINBOOL (CALLBACK PATCH_PROGRESS_CALLBACK)(PVOID CallbackContext

BOOL WINAPI	TestApplyPatchToFileA (LPCSTR PatchFileName, LPCSTR OldFileName, ULONG ApplyOptionFlags)

BOOL WINAPI	TestApplyPatchToFileW (LPCWSTR PatchFileName, LPCWSTR OldFileName, ULONG ApplyOptionFlags)

BOOL WINAPI	TestApplyPatchToFileByHandles (HANDLE PatchFileHandle, HANDLE OldFileHandle, ULONG ApplyOptionFlags)

BOOL WINAPI	ApplyPatchToFileA (LPCSTR PatchFileName, LPCSTR OldFileName, LPCSTR NewFileName, ULONG ApplyOptionFlags)

BOOL WINAPI	ApplyPatchToFileW (LPCWSTR PatchFileName, LPCWSTR OldFileName, LPCWSTR NewFileName, ULONG ApplyOptionFlags)

BOOL WINAPI	ApplyPatchToFileByHandles (HANDLE PatchFileHandle, HANDLE OldFileHandle, HANDLE NewFileHandle, ULONG ApplyOptionFlags)

BOOL WINAPI	GetFilePatchSignatureA (LPCSTR FileName, ULONG OptionFlags, PVOID OptionData, ULONG IgnoreRangeCount, PPATCH_IGNORE_RANGE IgnoreRangeArray, ULONG RetainRangeCount, PPATCH_RETAIN_RANGE RetainRangeArray, ULONG SignatureBufferSize, PVOID SignatureBuffer)

BOOL WINAPI	GetFilePatchSignatureW (LPCWSTR FileName, ULONG OptionFlags, PVOID OptionData, ULONG IgnoreRangeCount, PPATCH_IGNORE_RANGE IgnoreRangeArray, ULONG RetainRangeCount, PPATCH_RETAIN_RANGE RetainRangeArray, ULONG SignatureBufferSize, PVOID SignatureBuffer)

BOOL WINAPI	GetFilePatchSignatureByHandle (HANDLE FileHandle, ULONG OptionFlags, PVOID OptionData, ULONG IgnoreRangeCount, PPATCH_IGNORE_RANGE IgnoreRangeArray, ULONG RetainRangeCount, PPATCH_RETAIN_RANGE RetainRangeArray, ULONG SignatureBufferSize, PVOID SignatureBuffer)

Macro Definition Documentation

◆ APPLY_OPTION_FAIL_IF_CLOSE

#define APPLY_OPTION_FAIL_IF_CLOSE 0x00000002

Definition at line 27 of file patchapi.h.

◆ APPLY_OPTION_FAIL_IF_EXACT

#define APPLY_OPTION_FAIL_IF_EXACT 0x00000001

Definition at line 26 of file patchapi.h.

◆ APPLY_OPTION_TEST_ONLY

#define APPLY_OPTION_TEST_ONLY 0x00000004

Definition at line 28 of file patchapi.h.

◆ APPLY_OPTION_VALID_FLAGS

#define APPLY_OPTION_VALID_FLAGS 0x00000007

Definition at line 29 of file patchapi.h.

◆ ApplyPatchToFile

#define ApplyPatchToFile WINELIB_NAME_AW(ApplyPatchToFile)

Definition at line 69 of file patchapi.h.

◆ ERROR_PATCH_CORRUPT

#define ERROR_PATCH_CORRUPT 0xC00E4102

Definition at line 36 of file patchapi.h.

◆ ERROR_PATCH_DECODE_FAILURE

#define ERROR_PATCH_DECODE_FAILURE 0xC00E4101

Definition at line 35 of file patchapi.h.

◆ ERROR_PATCH_NEWER_FORMAT

#define ERROR_PATCH_NEWER_FORMAT 0xC00E4103

Definition at line 37 of file patchapi.h.

◆ ERROR_PATCH_NOT_AVAILABLE

#define ERROR_PATCH_NOT_AVAILABLE 0xC00E4106

Definition at line 40 of file patchapi.h.

◆ ERROR_PATCH_NOT_NECESSARY

#define ERROR_PATCH_NOT_NECESSARY 0xC00E4105

Definition at line 39 of file patchapi.h.

◆ ERROR_PATCH_WRONG_FILE

#define ERROR_PATCH_WRONG_FILE 0xC00E4104

Definition at line 38 of file patchapi.h.

◆ GetFilePatchSignature

#define GetFilePatchSignature WINELIB_NAME_AW(GetFilePatchSignature)

Definition at line 81 of file patchapi.h.

◆ TestApplyPatchToFile

#define TestApplyPatchToFile WINELIB_NAME_AW(TestApplyPatchToFile)

Definition at line 63 of file patchapi.h.

Typedef Documentation

◆ CurrentPosition

typedef ULONG CurrentPosition

Definition at line 57 of file patchapi.h.

◆ MaximumPosition

typedef ULONG ULONG MaximumPosition

Definition at line 57 of file patchapi.h.

◆ PATCH_IGNORE_RANGE

typedef struct _PATCH_IGNORE_RANGE PATCH_IGNORE_RANGE

◆ PATCH_RETAIN_RANGE

typedef struct _PATCH_RETAIN_RANGE PATCH_RETAIN_RANGE

◆ PPATCH_IGNORE_RANGE

typedef struct _PATCH_IGNORE_RANGE * PPATCH_IGNORE_RANGE

◆ PPATCH_PROGRESS_CALLBACK

typedef PATCH_PROGRESS_CALLBACK* PPATCH_PROGRESS_CALLBACK

Definition at line 58 of file patchapi.h.

◆ PPATCH_RETAIN_RANGE

typedef struct _PATCH_RETAIN_RANGE * PPATCH_RETAIN_RANGE

Function Documentation

◆ ApplyPatchToFileA()

BOOL WINAPI ApplyPatchToFileA	(	LPCSTR	PatchFileName,
		LPCSTR	OldFileName,
		LPCSTR	NewFileName,
		ULONG	ApplyOptionFlags
	)

Definition at line 230 of file mspatcha_main.c.

{
    BOOL ret = FALSE;
    HANDLE hPatch, hOld, hNew;
 
    hPatch = CreateFileA(patch_file, GENERIC_READ, FILE_SHARE_READ | FILE_SHARE_WRITE, NULL,
                         OPEN_EXISTING, FILE_FLAG_SEQUENTIAL_SCAN, 0);
    if (hPatch != INVALID_HANDLE_VALUE)
    {
        hOld = CreateFileA(old_file, GENERIC_READ, FILE_SHARE_READ | FILE_SHARE_WRITE, NULL,
                           OPEN_EXISTING, FILE_FLAG_SEQUENTIAL_SCAN, 0);
        if (hOld != INVALID_HANDLE_VALUE)
        {
            hNew = CreateFileA(new_file, GENERIC_READ | GENERIC_WRITE, FILE_SHARE_READ, NULL,
                               CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, 0);
            if (hNew != INVALID_HANDLE_VALUE)
            {
                ret = ApplyPatchToFileByHandles(hPatch, hOld, hNew, apply_flags);
                CloseHandle(hNew);
            }
            CloseHandle(hOld);
        }
        CloseHandle(hPatch);
    }
 
    return ret;
}

Referenced by apply_patch().

◆ ApplyPatchToFileByHandles()

BOOL WINAPI ApplyPatchToFileByHandles	(	HANDLE	PatchFileHandle,
		HANDLE	OldFileHandle,
		HANDLE	NewFileHandle,
		ULONG	ApplyOptionFlags
	)

Definition at line 388 of file mspatcha_main.c.

{
    SAFE_READ Patch, OldFile;
    DWORD dwStatus;
    PATCH_HEADER Header;
 
    Patch.Root = Patch.Ptr = MapFile(patch_file, &Patch.Size);
    if (!Patch.Root)
    {
        SetLastError(ERROR_PATCH_CORRUPT);
        return FALSE;
    }
 
    /* Let's decode the header */
    dwStatus = ParseHeader(&Patch, &Header);
    if (dwStatus != STATUS_SUCCESS)
    {
        UnmapViewOfFile(Patch.Root);
        SetLastError(dwStatus);
        return FALSE;
    }
 
    OldFile.Root = OldFile.Ptr = MapFile(old_file, &OldFile.Size);
    if (OldFile.Root)
    {
        DWORD dwCrc;
 
        /* Verify the input file */
        dwCrc = RtlComputeCrc32(0, OldFile.Root, OldFile.Size);
        if (OldFile.Size == Header.OldSize && dwCrc == Header.OldCrc)
        {
            if (apply_flags & APPLY_OPTION_TEST_ONLY)
                dwStatus = STATUS_SUCCESS;
            else
                dwStatus = CreateNewFileFromPatch(&Header, &Patch, new_file);
        }
        else
        {
            dwStatus = ERROR_PATCH_WRONG_FILE;
        }
        UnmapViewOfFile(OldFile.Root);
    }
    else
    {
        dwStatus = GetLastError();
        if (dwStatus == STATUS_SUCCESS)
            dwStatus = ERROR_PATCH_NOT_AVAILABLE;
    }
 
    UnmapViewOfFile(Patch.Root);
    SetLastError(dwStatus);
    return dwStatus == STATUS_SUCCESS;
}

Referenced by ApplyPatchToFileA(), ApplyPatchToFileW(), and TestApplyPatchToFileByHandles().

◆ ApplyPatchToFileW()

BOOL WINAPI ApplyPatchToFileW	(	LPCWSTR	PatchFileName,
		LPCWSTR	OldFileName,
		LPCWSTR	NewFileName,
		ULONG	ApplyOptionFlags
	)

Definition at line 445 of file mspatcha_main.c.

{
    BOOL ret = FALSE;
    HANDLE hPatch, hOld, hNew;
 
    hPatch = CreateFileW(patch_file, GENERIC_READ, FILE_SHARE_READ | FILE_SHARE_WRITE, NULL,
                         OPEN_EXISTING, FILE_FLAG_SEQUENTIAL_SCAN, 0);
    if (hPatch != INVALID_HANDLE_VALUE)
    {
        hOld = CreateFileW(old_file, GENERIC_READ, FILE_SHARE_READ | FILE_SHARE_WRITE, NULL,
                           OPEN_EXISTING, FILE_FLAG_SEQUENTIAL_SCAN, 0);
        if (hOld != INVALID_HANDLE_VALUE)
        {
            hNew = CreateFileW(new_file, GENERIC_READ | GENERIC_WRITE, FILE_SHARE_READ, NULL,
                               CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, 0);
            if (hNew != INVALID_HANDLE_VALUE)
            {
                ret = ApplyPatchToFileByHandles(hPatch, hOld, hNew, apply_flags);
                CloseHandle(hNew);
            }
            CloseHandle(hOld);
        }
        CloseHandle(hPatch);
    }
 
    return ret;
}

Referenced by apply_filepatch().

◆ GetFilePatchSignatureA()

BOOL WINAPI GetFilePatchSignatureA	(	LPCSTR	FileName,
		ULONG	OptionFlags,
		PVOID	OptionData,
		ULONG	IgnoreRangeCount,
		PPATCH_IGNORE_RANGE	IgnoreRangeArray,
		ULONG	RetainRangeCount,
		PPATCH_RETAIN_RANGE	RetainRangeArray,
		ULONG	SignatureBufferSize,
		PVOID	SignatureBuffer
	)

Definition at line 476 of file mspatcha_main.c.

{
    BOOL ret = FALSE;
    HANDLE hFile;
 
    hFile = CreateFileA(filename, GENERIC_READ, FILE_SHARE_READ | FILE_SHARE_WRITE, NULL,
                        OPEN_EXISTING, FILE_FLAG_SEQUENTIAL_SCAN, 0);
    if (hFile != INVALID_HANDLE_VALUE)
    {
        ret = GetFilePatchSignatureByHandle(hFile, flags, data, ignore_range_count, ignore_range,
                                            retain_range_count, retain_range, bufsize, buffer);
        CloseHandle(hFile);
    }
 
    return ret;
}

Referenced by validate_signature().

◆ GetFilePatchSignatureByHandle()

BOOL WINAPI GetFilePatchSignatureByHandle	(	HANDLE	FileHandle,
		ULONG	OptionFlags,
		PVOID	OptionData,
		ULONG	IgnoreRangeCount,
		PPATCH_IGNORE_RANGE	IgnoreRangeArray,
		ULONG	RetainRangeCount,
		PPATCH_RETAIN_RANGE	RetainRangeArray,
		ULONG	SignatureBufferSize,
		PVOID	SignatureBuffer
	)

Definition at line 498 of file mspatcha_main.c.

{
    BOOL ret = FALSE;
    DWORD dwSize, ulCrc;
    PBYTE pData;
 
    if (flags)
        FIXME("Unhandled flags 0x%x\n", flags);
    if (ignore_range_count)
        FIXME("Unhandled ignore_range_count %u\n", ignore_range_count);
    if (retain_range_count)
        FIXME("Unhandled ignore_range_count %u\n", retain_range_count);
 
    if ((pData = MapFile(hFile, &dwSize)))
    {
        if (dwSize >= 2 && *(PWORD)pData == IMAGE_DOS_SIGNATURE)
        {
            FIXME("Potentially unimplemented case, normalized signature\n");
        }
 
        ulCrc = RtlComputeCrc32(0, pData, dwSize);
        if (bufsize >= SIGNATURE_MIN_SIZE)
        {
            char *pBuffer = buffer;
            pBuffer[8] = '\0';
            for (dwSize = 0; dwSize < 8; ++dwSize)
            {
                pBuffer[7 - dwSize] = szHexString[ulCrc & 0xf];
                ulCrc >>= 4;
            }
            ret = TRUE;
        }
        UnmapViewOfFile(pData);
 
        if (bufsize < SIGNATURE_MIN_SIZE)
            SetLastError(ERROR_INSUFFICIENT_BUFFER);
    }
 
    return ret;
}

Referenced by GetFilePatchSignatureA(), GetFilePatchSignatureW(), and validate_signature().

◆ GetFilePatchSignatureW()

BOOL WINAPI GetFilePatchSignatureW	(	LPCWSTR	FileName,
		ULONG	OptionFlags,
		PVOID	OptionData,
		ULONG	IgnoreRangeCount,
		PPATCH_IGNORE_RANGE	IgnoreRangeArray,
		ULONG	RetainRangeCount,
		PPATCH_RETAIN_RANGE	RetainRangeArray,
		ULONG	SignatureBufferSize,
		PVOID	SignatureBuffer
	)

Definition at line 544 of file mspatcha_main.c.

{
    CHAR LocalBuf[SIGNATURE_MIN_SIZE];
    BOOL ret = FALSE;
    HANDLE hFile;
 
    hFile = CreateFileW(filename, GENERIC_READ, FILE_SHARE_READ | FILE_SHARE_WRITE, NULL,
                        OPEN_EXISTING, FILE_FLAG_SEQUENTIAL_SCAN, 0);
    if (hFile != INVALID_HANDLE_VALUE)
    {
        ret = GetFilePatchSignatureByHandle(hFile, flags, data, ignore_range_count, ignore_range,
                                            retain_range_count, retain_range, sizeof(LocalBuf), LocalBuf);
        CloseHandle(hFile);
 
        if (bufsize < (SIGNATURE_MIN_SIZE * sizeof(WCHAR)))
        {
            SetLastError(ERROR_INSUFFICIENT_BUFFER);
            return FALSE;
        }
        if (ret)
        {
            MultiByteToWideChar(CP_ACP, 0, LocalBuf, -1, buffer, bufsize / sizeof(WCHAR));
        }
    }
 
    return ret;
}