OEMCheckSignature

  • Article

This function verifies the signature in the .bin file.

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

Parameters

  • dwImageStart
    [in] Starting address of the OS image—.bin file. This is the address where the whole OS image is currently stored, typically in RAM.
  • dwROMOffset
    [in] Corresponds to the ROMOFFSET value in the .bib file—Config.bib if it is an OS image. This parameter is used to translate between where the OS image is stored, for example, flash memory, versus where it is fixed up to run from, for example, RAM.
  • dwLaunchAddr
    [in] Launch address of the OS image, which is the address that the boot loader jumps to. 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 being performed on a local, or resident, OS image.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

g_pOEMCheckSignature is a function pointer. An OEM 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.

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

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

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

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.