OEMCheckSignature (Windows CE 5.0)

Send Feedback

This function verifies the signature in the .bin file.

BOOL OEMCheckSignature(DWORDdwImageStart,DWORDdwROMOffset,DWORDdwLaunchAddr,BOOLbDownloaded);

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 Values

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

OS Versions: Windows CE .NET 4.2 and later.
Header: Blcommon.h.
Link Library: Blcommon.lib.

See Also

OEMVerifyMemory | OEMMultiBINNotify | Adding Support for Image Signatures

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.