HrTraceOpenEntry

The HrTraceOpenEntry function retrieves a pointer to a trace entry.

Quick Info

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