Platform SDK: Exchange Server

HrTrackWriteLog

The HrTrackWriteLog function logs a gateway tracking event.

Quick Info

Header file: EDKTRACK.H
Library: EDKTRACK.LIB
Unicode: Yes

HRESULT HrTrackWriteLog(
  PVOID pvSession,        
  UINT nEventType,        
  SYSTEMTIME stEvent,     
  LPTSTR lpszGatewayName,  
  LPTSTR lpszPartner,     
  LPTSTR lpszMTSID,       
  LPTSTR lpszRemoteID,    
  LPTSTR lpszOriginator,  
  INT nPriority,          
  INT nLength,            
  INT nSeconds,           
  INT nCost,              
  INT cRecipients,        
  LPTSTR * lppszRecipients  
);
 

Parameters

pvSession
Input parameter. Gateway tracking session.
nEventType
Input parameter. Gateway tracking event type.
stEvent
Input parameter. System time at which the event took place. Not necessarily when the transfer happened.
lpszGatewayName
Input parameter. Distinguished name (DN) of the gateway.
lpszPartner
Input parameter. Name of a remote system. A DN is preferable, but any name unique within the gateway class is acceptable.
lpszMTSID
Input parameter. MTSID of the message. This can be left blank in the case of a message submission.
lpszRemoteID
Input parameter. Identifier of the message in the foreign system. This parameter is not required.
lpszOriginator
Input parameter. DN or string for the originator of the message. Queries function better if this is input as a DN.
nPriority
Input parameter. Message priority. (Optional information. Use if available.)
nLength
Input parameter. Message length. (Optional information. Use if available.)
nSeconds
Input parameter. Seconds to process this message. (Optional information. Use if available.)
nCost
Input parameter. Cost of processing this message. (Optional information. Use if available.)
cRecipients
Input parameter. The number of recipients in lppszRecipients.
lppszRecipients
Input parameter. The recipients of the message (preferably a series of DNs).

Return Values

See Return Values.

Remarks

For more information on this function, see Using Tracking Functions.

See the description of EDKTRACK.LIB in TRACK: Tracking and Auditing Messages, for a listing of events that can be tracked.

See Also

HrTrackInitLog, HrTrackUninitLog