GetFileTagDataType Method

Retrieves the data type of a typed file tag attached to a specific vault item.


int GetFileTagDataType(const QString& qsFileName, const QString& qsTagName);


This method retrieves the data type of a typed file tag, identified by TagName, attached to the vault item (file, directory, or alternate stream) specified by FileName. If there isn't a typed file tag with the specified TagName attached to the specified vault item, this method fails with an error.

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 returned by this method will be one of the following (except CBFSSTORAGE_TDT_RAWDATA, which is not applicable):

CBFSSTORAGE_TDT_RAWDATA0x0The tag is untyped and must be addressed by Id.

CBFSSTORAGE_TDT_BOOLEAN0x1The tag contains Boolean data and must be addressed by name.

CBFSSTORAGE_TDT_STRING0x2The tag contains String (UTF-16LE) data and must be addressed by name.

CBFSSTORAGE_TDT_DATETIME0x3The tag contains DateTime data and must be addressed by name.

CBFSSTORAGE_TDT_NUMBER0x4The tag contains numeric (signed 64-bit) data and must be addressed by name.

CBFSSTORAGE_TDT_ANSISTRING0x5The tag contains AnsiString (8-bit string) data and must be addressed by name.

Please refer to the File Tags topic for more information.

Note: This method can only be called when Active is true.

Error Handling

This method returns an Integer 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.

Copyright (c) 2022 Callback Technologies, Inc. - All rights reserved.
CBFS Vault 2020 Qt Edition - Version 20.0 [Build 8145]