221 lines
11 KiB
C
221 lines
11 KiB
C
|
#ifndef NESYU_INC
|
||
|
|
#define NESYU_INC
|
||
|
|
|
||
|
|
#include "nesy.h"
|
||
|
|
|
||
|
|
// This file and the bobbit program are the only documentation on the nesy read only
|
||
|
|
// database system.
|
||
|
|
|
||
|
|
//
|
||
|
|
// CreateDatabase
|
||
|
|
//
|
||
|
|
// Creates a new database
|
||
|
|
BOOL CreateDatabase(
|
||
|
|
LPCTSTR szDatabasePath // directory where the database is to be created.
|
||
|
|
);
|
||
|
|
|
||
|
|
// Returns a buffer with the blob ids listed. The caller is responsible for freeing
|
||
|
|
// this buffer when finished with it.
|
||
|
|
|
||
|
|
//
|
||
|
|
// List
|
||
|
|
//
|
||
|
|
// Returns a buffer with the blobs from iBeginID to iEndID listed. The caller is
|
||
|
|
// responsible for freeing this buffer when finished with it.
|
||
|
|
|
||
|
|
BOOL List(
|
||
|
|
int iLevel, // Level of information desired, 0 lists the blobs only, 1 lists the contents of the blob as well.
|
||
|
|
LPCTSTR szDatabasePath, // directory path where database is, use ".\\" to specify the current directory.
|
||
|
|
int iBeginID, // Beginning blob id to list, -1 means begin at beginning of the database.
|
||
|
|
int iEndID // ending blob id to list, -1 means no end blob so all are listed.
|
||
|
|
);
|
||
|
|
|
||
|
|
//
|
||
|
|
// SearchDatabase
|
||
|
|
//
|
||
|
|
// Returns a buffer with the blob ids listed. The caller is responsible for freeing
|
||
|
|
// this buffer when finished with it.
|
||
|
|
|
||
|
|
BOOL SearchDatabase(
|
||
|
|
LPCTSTR szSearchString, // search string to be found in database.
|
||
|
|
int iLevel, // Level of information desired, 0 lists the blobs only, 1 lists the contents of the blob as well.
|
||
|
|
LPCTSTR szDatabasePath // directory path where database is, use ".\\" to specify the current directory.
|
||
|
|
);
|
||
|
|
|
||
|
|
//
|
||
|
|
// UpdateBlob
|
||
|
|
//
|
||
|
|
// Updates a specific blob in the database with the specified file.
|
||
|
|
// The return value is the blob id if successfull or -1 if an error occurs.
|
||
|
|
|
||
|
|
int UpdateBlob(
|
||
|
|
int blobID, // blob id to add to the database
|
||
|
|
LPCTSTR szBlobFile, // blob file to be added to the database
|
||
|
|
LPCTSTR szDatabasePath // directory path where database is, use ".\\" to specify the current directory.
|
||
|
|
);
|
||
|
|
|
||
|
|
//
|
||
|
|
// UpdateBlob
|
||
|
|
//
|
||
|
|
// Updates a specific blob in the database with the blob in memory.
|
||
|
|
// The return value is the blob id if successfull or -1 if an error occurs.
|
||
|
|
|
||
|
|
int UpdateBlob(
|
||
|
|
int blobID, // blob id to add to the database
|
||
|
|
LPVOID pBlob, // memory buffer containing blob to be added to the database.
|
||
|
|
DWORD dwBlobSize, // size of blob to be added to the database.
|
||
|
|
LPCTSTR szDatabasePath // directory path where database is, use ".\\" to specify the current directory.
|
||
|
|
);
|
||
|
|
|
||
|
|
//
|
||
|
|
// WriteBlob
|
||
|
|
//
|
||
|
|
// Write a specific blob file to the database. Pass in -1 for the blob id to
|
||
|
|
// add a new blob to the database. The return value is the blob id
|
||
|
|
// if successfull or -1 if an error occurs.
|
||
|
|
int WriteBlob(
|
||
|
|
int blobID, // blob id to add to the database
|
||
|
|
LPCTSTR szBlobFile, // blob file to be added to the database
|
||
|
|
LPCTSTR szDatabasePath // directory path where database is, use ".\\" to specify the current directory.
|
||
|
|
);
|
||
|
|
|
||
|
|
//
|
||
|
|
// WriteBlob
|
||
|
|
//
|
||
|
|
// Write a specific blob in memory to the database. Pass in -1 for the blob id to
|
||
|
|
// add a new blob to the database. The return value is the blob id
|
||
|
|
// if successfull or -1 if an error occurs.
|
||
|
|
int WriteBlob(
|
||
|
|
int blobID, // blob id to add to the database
|
||
|
|
LPVOID pBlob, // memory buffer containing blob to be added to the database.
|
||
|
|
DWORD dwBlobSize, // size of blob to be added to the database.
|
||
|
|
LPCTSTR szDatabasePath // directory path where database is, use ".\\" to specify the current directory.
|
||
|
|
);
|
||
|
|
|
||
|
|
//
|
||
|
|
// DeleteBlob
|
||
|
|
//
|
||
|
|
// delete the specified blob. returns TRUE if successfull or FALSE if not.
|
||
|
|
BOOL DeleteBlob(
|
||
|
|
int blobID, // blob id to add to the database
|
||
|
|
LPCTSTR szDatabasePath // directory path where database is, use ".\\" to specify the current directory.
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
//
|
||
|
|
// AddShimDll
|
||
|
|
//
|
||
|
|
// Adds a new shim dll to the database's blob 0. This API returns the blob id if successfull or -1 if an
|
||
|
|
// error occurs. In the case of an error GetLastError() can be checked to get additional information
|
||
|
|
// as to the specific cause of the error.
|
||
|
|
|
||
|
|
int AddShimDll(
|
||
|
|
PBLOB0 *ppBlob0, // Blob 0 pointer. If the blob is successfully added then this pointer is updated with the new blob0
|
||
|
|
DWORD *pdwShimID, // If successful, passes back the ID of the shim DLL record created
|
||
|
|
LPCTSTR szBlobFile, // Shim DLL to be added to the database
|
||
|
|
LPCTSTR szDatabasePath // directory path where database is, use ".\\" to specify the current directory.
|
||
|
|
);
|
||
|
|
|
||
|
|
//
|
||
|
|
// AddPatchBlob
|
||
|
|
//
|
||
|
|
// Adds a new shim dll to the database's blob 0. This API returns the blob id if successfull or -1 if an
|
||
|
|
// error occurs. In the case of an error GetLastError() can be checked to get additional information
|
||
|
|
// as to the specific cause of the error.
|
||
|
|
|
||
|
|
int AddPatchBlob(
|
||
|
|
PBLOB0 *ppBlob0, // Blob 0 pointer. If the blob is successfully added then this pointer is updated with the new blob0
|
||
|
|
LPCTSTR szBlobFile, // Patch blob to be added to the database
|
||
|
|
LPCTSTR szDescription, // Description of this patch, this is for information purposes only.
|
||
|
|
LPCTSTR szDatabasePath // directory path where database is, use ".\\" to specify the current directory.
|
||
|
|
);
|
||
|
|
//
|
||
|
|
// AddExe
|
||
|
|
//
|
||
|
|
// This method adds a new exe to blob 0. Then function returns the unique id of the exe that was added. This id can
|
||
|
|
// be used to later identify the exe. In the case of an error this function returns 0. The function GetLastError()
|
||
|
|
// can then be checked to determine the cause of the error.
|
||
|
|
|
||
|
|
DWORD AddExe(
|
||
|
|
PBLOB0 *ppBlob0, // Blob 0 pointer. If the exe is successfully added then this pointer is updated with the new blob0
|
||
|
|
PDWORD pdwBlobPatchID, // array for DWORDs that identify the patch DLL's to be used for this exe
|
||
|
|
DWORD dwTotalPatchBlobs,// total patch blobs in previous array.
|
||
|
|
PLARGE_INTEGER pqwFlags,// Flags associated with this exe.
|
||
|
|
LPCTSTR szFileName // exe that is to be hooked with the shim DLL's identified by the pdwBlobID parameter.
|
||
|
|
);
|
||
|
|
|
||
|
|
//
|
||
|
|
// AddGlobalInclude
|
||
|
|
//
|
||
|
|
// Adds a module to the global include list. This list will largely or completely consist of windows system
|
||
|
|
// DLLs that shouldn't be patched, so mostly it will be exclusions.
|
||
|
|
// This list can be overridden by inclusion lists at the DLL or EXE level
|
||
|
|
// returns TRUE/FALSE for success.
|
||
|
|
|
||
|
|
BOOL AddGlobalInclude(
|
||
|
|
PBLOB0 *ppBlob0, // Blob 0 pointer. If the blob is successfully added then this pointer is updated with the new blob0
|
||
|
|
INCTYPE eType, // the type: INCLUDE or EXCLUDE
|
||
|
|
LPCTSTR szModule, // The module to exclude from shimming
|
||
|
|
LPCTSTR szAPI, // the specific API call that should be excluded, or NULL for all APIs
|
||
|
|
DWORD dwModuleOffset // used to specify a specific call instance that should be excluded
|
||
|
|
);
|
||
|
|
|
||
|
|
//
|
||
|
|
// AddShimDllInclude
|
||
|
|
//
|
||
|
|
// Adds an include item to the Shim DLL record, which allows a shim dll to shim a DLL which would otherwise
|
||
|
|
// be excluded by the global exclusion list. Otherwise much like AddGlobalExclude.
|
||
|
|
BOOL AddShimDllInclude(
|
||
|
|
PBLOB0 *ppBlob0, // Blob 0 pointer. If the blob is successfully added then this pointer is updated with the new blob0
|
||
|
|
DWORD dwShimID, // the ID of the shim record, passed back from AddShimDLL
|
||
|
|
INCTYPE eType, // the type: INCLUDE or EXCLUDE
|
||
|
|
LPCTSTR szModule, // the module to add to the shim list
|
||
|
|
LPCTSTR szAPI, // the specific API to include
|
||
|
|
DWORD dwModuleOffset // used to specify a specific call instance that should be included
|
||
|
|
);
|
||
|
|
|
||
|
|
//
|
||
|
|
// AddDllRef
|
||
|
|
//
|
||
|
|
// Adds to an Exe record a reference to a shim DLL that should be loaded when the executable is loaded
|
||
|
|
// Inclusions or exclusions of specific modules or calls can be added later by
|
||
|
|
BOOL AddDllRef(
|
||
|
|
PBLOB0 *ppBlob0, // Blob 0 pointer. If the blob is successfully added then this pointer is updated with the new blob0
|
||
|
|
DWORD dwExeID, // the exe ID, passed back from AddExe
|
||
|
|
DWORD *pdwDllRefID, // passes back the Dll ref ID, used to add include/exclude info later
|
||
|
|
DWORD dwBlobID // the blob ID of the dll that should be added
|
||
|
|
);
|
||
|
|
|
||
|
|
//
|
||
|
|
// AddDllRefInclude
|
||
|
|
//
|
||
|
|
// Adds an include item to the DLL ref record, which allows adding a DLL for a specific exe which would otherwise
|
||
|
|
// be excluded by the global exclusion list or the Shim DLL exclusion list. Otherwise much like AddGlobalExclude.
|
||
|
|
BOOL AddDllRefInclude(
|
||
|
|
PBLOB0 *ppBlob0, // Blob 0 pointer. If the blob is successfully added then this pointer is updated with the new blob0
|
||
|
|
DWORD dwDllRefID, // the ID of the Dll ref record, passed back from AddDllRef
|
||
|
|
INCTYPE eType, // the type: INCLUDE or EXCLUDE
|
||
|
|
LPCTSTR szModule, // the module to add to the shim list
|
||
|
|
LPCTSTR szAPI, // the specific API to include
|
||
|
|
DWORD dwModuleOffset // used to specify a specific call instance that should be included
|
||
|
|
);
|
||
|
|
|
||
|
|
//
|
||
|
|
// AddMatchingInfo
|
||
|
|
//
|
||
|
|
// This method adds a new matching file to an exe in blob 0. The exe is identified by the id returned from the AddExe
|
||
|
|
// method. This method returns TRUE if the matching info is successfully added or FALSE if an error occurs. In the case
|
||
|
|
// of an failure the GetLastError() function can be checked to determine the cause of the error.
|
||
|
|
|
||
|
|
BOOL AddMatchingInfo(
|
||
|
|
PBLOB0 *ppBlob0, // Blob 0 pointer. If the exe is successfully added then this pointer is updated with the new blob0
|
||
|
|
DWORD dwExeID, // Exe id where matching info is to be added. This id is returned from the AddExe function.
|
||
|
|
LPCTSTR szFileName, // relative path file name of the matching file. This path is relative to the exe file
|
||
|
|
// that this matching file is being added to.
|
||
|
|
DWORD dwSize = 0, // Size of the matching file. This parameter can be 0 if size is not to be a criteria.
|
||
|
|
DWORD dwCrc = 0, // Crc of the matching file. This parameter can be 0 if size is not to be a criteria.
|
||
|
|
PFILETIME pFt = NULL // file time of the matching file. This parameter can be 0 if size is not to be a criteria.
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
#endif
|