OEMCheckSignature (Windows Embedded CE 6.0)

1/5/2010

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 OS image or .bin file. This is the address where the OS 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 an OS image. This parameter translates between where the OS 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 OS image, which is the address to which the boot loader jumps. It is the main entry point for the downloaded OS image.
  • bDownloaded
    [in] Specifies either TRUE or FALSE and describes whether the OS image was downloaded or whether a signature check is performed on a local, or resident, OS 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
Windows Embedded CE Windows CE .NET 4.2 and later

See Also

Reference

Optional Boot Loader Functions
OEMVerifyMemory
OEMMultiBINNotify

Concepts

Adding Support for Image Signatures