SetFileTagAsDateTime Method

Attaches a DateTime-typed file tag to the specified vault item.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int SetFileTagAsDateTime(const char* lpszFileName, const char* lpszTagName, int64 lValue);

Unicode (Windows)
INT SetFileTagAsDateTime(LPCWSTR lpszFileName, LPCWSTR lpszTagName, LONG64 lValue);

- (void)setFileTagAsDateTime:(NSString*)fileName :(NSString*)tagName :(NSDate*)value;

#define MID_CBVAULT_SETFILETAGASDATETIME 64

CBFSVAULT_EXTERNAL int CBFSVAULT_CALL CBFSVault_CBVault_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method attaches a DateTime-typed file tag to the vault item (file, directory, or alternate stream) specified by FileTag using the specified TagName. If a typed file tag with the specified TagName is already attached to the specified vault item, it is replaced.

The value passed for FileName must be a vault-local absolute path. The value passed for TagName may be up to 4095 characters in length (not including the null terminator).

The Value parameter specifies the DateTime value to store in the file tag, which must be specified as a number of 100-nanosecond intervals since Jan 1, 1601 00:00:00 UTC, i.e., as FILETIME.

Please refer to the File Tags topic for more information.

Note: This method can only be called when Active is true, and cannot be called within events.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)