CeLogData (Compact 2013)

  • Article

3/28/2014

This function is called by the kernel whenever an event occurs that can be logged.

Syntax

void CeLogData(
  BOOL fTimeStamp, 
  WORD wID, 
  PVOID pData, 
  WORD wLen, 
  DWORD dwZoneUser, 
  DWORD dwZoneCE, 
  WORD wFlag, 
  BOOL fFlagged 
);

Parameters

  • fTimeStamp
    [in] Identifies whether a time stamp is needed. When set to TRUE, a time stamp is needed to coincide with the logged event.

  • wID
    [in] Identifier of the event that has occurred.

    For more information about events, see CeLog Event Identifiers.

  • pData
    [in] Pointer to a buffer that contains the data of the logged event.
  • wLen
    [in] Length of data pointed to by pData. Each event can have a differently sized structure.
  • dwZoneUser
    [in] User-defined zone. OEMs can create their own zones to track events.

  • dwZoneCE
    [in] Zone of the event that was logged and identified by wID.

    For more information about zones, see CeLog Zones.

  • wFlag
    [in] User-defined flag.
  • fFlagged
    [in] Indicates whether to use the user-defined flag, wFlag. If set to TRUE, wFlag has been specified. If set to FALSE, wFlag is ignored.

Return Value

None.

Remarks

Note

Do not log protected information to CeLogData because a malicious user could compromise the system and collect this information.

Note

Do not take a pointer from a caller and write it to CeLogData without first using access-checking APIs such as CeOpenCallerBuffer, which are designed to prevent callers from reading system data.

Requirements

Header

celog.h

Library

coredll.lib

See Also

Reference

CeLog Event Tracking Functions
Process and Thread Functions