OEMCheckSignature (Compact 2013)

10/16/2014

This function verifies the signature in the .bin file.

Syntax

BOOL OEMCheckSignature(
  DWORD dwImageStart,
  DWORD dwROMOffset,
  DWORD dwLaunchAddr,
  BOOL bDownloaded
);

Parameters

• dwImageStart
  [in] Starting address of the run-time image or .bin file. This is the address where the run-time image is currently stored, typically in RAM.

• dwROMOffset
  [in] Corresponds to the ROMOFFSET value in the .bib file, which is Config.bib, if the file is a run-time image. This parameter translates between where the run-time image is stored and where it runs. For example, it might be stored in flash memory, but run from RAM.

• dwLaunchAddr
  [in] Launches the address of the run-time image, which is the address to which the boot loader jumps. It is the main entry point for the downloaded run-time image.

• bDownloaded
  [in] Specifies either TRUE or FALSE and describes whether the run-time image was downloaded or whether a signature check is performed on a local, or resident, run-time image.

Return Value

TRUE indicates success. FALSE indicates failure.

Remarks

g_pOEMCheckSignature is a function pointer. You can assign the address of a custom check signature routine that the BLCOMMON code then calls at the appropriate time through this function pointer. The following code example shows how you can perform this routine.

BOOL OEMCheckSignature(DWORD dwImageStart, DWORD dwROMOffset, DWORD dwLaunchAddr, BOOL bDownloaded);
g_pOEMCheckSignature = OEMCheckSignature;

g_pOEMCheckSignature can call back to the OEMCheckSignature function to check most of the signature.

Requirements

Header	blcommon.h
Library	blcommon.lib

See Also

Reference

Optional Boot Loader Functions
OEMVerifyMemory
OEMMultiBINNotify