2.2.12.2 TRKSVR_CALL_REFRESH

  • Article

The TRKSVR_CALL_REFRESH structure is used in LnkSvrMessage method calls that specify a REFRESH message (see section 2.2.11), to indicate to the server that a file or volume is still in use. The server uses this to determine when an entry in its tables is no longer in use and can be deleted. See section 3.2.5.2 for an example of client use of this structure.

 typedef struct {
   unsigned long cSources;
   [size_is(cSources)] CDomainRelativeObjId* adroidBirth;
   unsigned long cVolumes;
   [size_is(cVolumes)] CVolumeId* avolid;
 } TRKSVR_CALL_REFRESH;

cSources: This field MUST contain the number of elements in the adroidBirth array.

adroidBirth: This field MUST contain an array of FileIDs, with the FileID for files on the client computer for which the client is requesting a refresh. The type of this field, CDomainRelativeObjId, is as specified in [MS-DLTW] section 2.2.3. If this array is empty, it indicates that there are no FileIDs to be refreshed by this request.

cVolumes: This field MUST contain the number of elements in the avolid array. Note that this is independent of the cSources value.

avolid: This field MUST contain an array of VolumeIDs for volumes on the client computer for which the client requests a refresh. CVolumeId is as specified in [MS-DLTW] section 2.2.4. If this array is empty, it indicates that there are no VolumeIDs to be refreshed by this request.