HrTraceOpenEntry

The HrTraceOpenEntry function retrieves a pointer to a trace entry.

Quick Info

Header file: EDKMAPI.H
Library: EDKMAPI.LIB

HRESULT HrTraceOpenEntry(
  LPTRACEENTRY lpTraceEntry,  
  LONG *plAction,           
  FILETIME *pftArrivalTime,  
  FILETIME *pftDeferredTime,  
  LPSTR *lppszADMDName,     
  LPSTR *lppszCountryName,  
  LPSTR *lppszPRMDId,       
  LPSTR *lppszAttADMDName,  
  LPSTR *lppszAttCountryName,  
  LPSTR *lppszAttPRMDId     
);
 

Parameters

lpTraceEntry
Input parameter. Points to a TRACEENTRY structure containing the trace entry.
plAction
Output parameter. Routing action taken by the tracing site.
pftArrivalTime
Output parameter. Time at which the communique entered the tracing site.
pftDeferredTime
Output parameter. Time at which the tracing site released the message.
lppszADMDName
Output parameter. ADMD Name.
lppszCountryName
Output parameter. Country Name.
lppszPRMDId
Output parameter. PRMD Identifier.
lppszAttADMDName
Output parameter. Attempted ADMD Name.
lppszAttCountryName
Output parameter. Attempted Country Name.
lppszAttPRMDId
Output parameter. Attempted PRMD Identifier.

Return Values

See Return Values.

Remarks

You should ensure that pftArrivalTime is less than pftDeferredTime.

For more information on this function, see the HrTraceOpenEntry function in ITRACE.C under the EDKMAPI code sample in the Code Samples folder.

See Also

HrTraceCopyEntry, HrTraceGotoEntry, HrTraceGotoFirstEntry, HrTraceGotoNextEntry