2.2.8 TRK_FILE_TRACKING_INFORMATION

The TRK_FILE_TRACKING_INFORMATION structure is used in a SEARCH message of a LnkSvrMessage method call to search for the current location of a file. This structure contains information about a file that is being tracked. See section 2.2.11 for more information about the SEARCH message. See section 3.2.6.3 for an example of how the TRK_FILE_TRACKING_INFORMATION structure is used.

 typedef struct {
   CDomainRelativeObjId droidBirth;
   CDomainRelativeObjId droidLast;
   CMachineId mcidLast;
   HRESULT hr;
 } TRK_FILE_TRACKING_INFORMATION;

droidBirth: The FileID of the file for which the location is being requested. For details on this structure, see [MS-DLTW] section 2.2.3.

droidLast: On input, the last FileLocation that the client knew of for the file. On output, this member contains the file's current FileLocation.

mcidLast: On completion of the SEARCH request, this member is returned by the server to indicate the MachineID of the VolumeOwner of the VolumeID component of the droidLast field. The CMachineId type is specified in [MS-DLTW] section 2.2.2.

hr: Return value that indicates the success or failure of this message. The type of this field is an HRESULT but, unlike the standard definition, only zero is a successful return value for this field. Any nonzero value MUST be treated identically as a failure value.