2.2.11 TRKSVR_MESSAGE_TYPE

  • Article

The TRKSVR_MESSAGE_TYPE enumeration defines the type of a message that is sent to the DLT Central Manager server by the LnkSvrMessage method. That is, the LnkSvrMessage method is defined such that the caller can send different messages in the form of different structures, and the TRKSVR_MESSAGE_TYPE enumeration is used in the TRKSVR_MESSAGE_UNION parameter of the LnkSvrMessage method to indicate which structure is being passed in a method call. See section 2.2.12 for information on TRKSVR_MESSAGE_UNION, and section 3.1.4.1 for more information on the LnkSvrMessage method.

 typedef [v1_enum] enum 
 {
   old_SEARCH,
   MOVE_NOTIFICATION = 1,
   REFRESH = 2,
   SYNC_VOLUMES = 3,
   DELETE_NOTIFY = 4,
   STATISTICS = 5,
   SEARCH = 6,
   WKS_CONFIG,
   WKS_VOLUME_REFRESH
 } TRKSVR_MESSAGE_TYPE;

old_SEARCH:  Unused.

MOVE_NOTIFICATION:  The message includes information about one or more files that have been moved (see section 3.2.6.1). The message data in this method call is formatted in the TRSVR_CALL_MOVE_NOTIFICATION structure (see section 2.2.12.1).

REFRESH:  The message communicates the current status of the entries in the ClientVolumeTable, so that the server can update its ServerVolumeTable (see section 3.2.5.2). The message data in this method call is formatted in the TRKSVR_CALL_REFRESH structure (see section 2.2.12.2).

SYNC_VOLUMES:  The message is used to synchronize a volume (see sections 3.2.5.3, 3.2.5.4, and 3.2.6.4). The message data in this method call is formatted in the TRKSVR_CALL_SYNC_VOLUMES structure (see section 2.2.12.3).

DELETE_NOTIFY:  The message includes information about one or more files that have been deleted (see section 3.2.5.5). The message data in this method call is formatted in the TRKSVR_CALL_DELETE structure (see section 2.2.12.4).

STATISTICS:  The message is a request for usage statistics. This message type is not used in this protocol, but is included in this specification because it affects the size of the TRKSVR_MESSAGE_UNION structure as it is transmitted over the RPC Protocol. See section 2.2.12 for more information on the TRKSVR_MESSAGE_UNION.

SEARCH:  The message is a request for information about a moved file’s updated location. (see section 3.2.6.3). The message data in this method call is formatted in the TRKSVRidl_struct_page_CALL_SEARCH structure (see section 2.2.12.6).

WKS_CONFIG:  Unused.

WKS_VOLUME_REFRESH:  Unused.