GetSearchResultModificationTime Method
Retrieves the modification time of a vault item found during a search operation.
Syntax
ANSI (Cross Platform) int64 GetSearchResultModificationTime(int64 lSearchHandle); Unicode (Windows) LONG64 GetSearchResultModificationTime(LONG64 lSearchHandle);
- (NSDate*)getSearchResultModificationTime:(long long)searchHandle;
#define MID_CBDRIVE_GETSEARCHRESULTMODIFICATIONTIME 55 CBFSSTORAGE_EXTERNAL int CBFSSTORAGE_CALL CBFSStorage_CBDrive_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);
Remarks
This method retrieves the modification time of a vault item (file, directory, symbolic link, or alternate stream) found via FindFirst/FindFirstByQuery/FindNext as part of the search operation identified by SearchHandle. Please refer to those methods' documentation for more information.
The value passed for SearchHandle must be a search operation handle returned by FindFirst or FindFirstByQuery.
The timestamps returned by this method are specified as a number of 100-nanosecond intervals since Jan 1, 1601 00:00:00 UTC(on all supported platforms!), i.e., as FILETIME.
If times were not requested as part of the specified search operation (by passing either 0 or a value including CBFSSTORAGE_FF_NEED_TIMES for the FindFirst/FindFirstByQuery method's Flags parameter), this method will always return 0. Please refer to the documentation for these methods for more information.
Note: This method can only be called when Active is true.
Error Handling (C++)
This method returns a Long64 value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.