CBFS Vault 2020 Python Edition

Questions / Feedback?

set_file_tag_as_ansi_string Method

Attaches an AnsiString-typed file tag to the specified vault item.


def set_file_tag_as_ansi_string(file_name: str, tag_name: str, value: str) -> None: ...


This method attaches an AnsiString-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 AnsiString value to store in the file tag; it may be up to 65529 - (name_length * 2) bytes in length (where name_length is measured in characters), including null terminators for both the AnsiString value and the name.

Please refer to the File Tags topic for more information.

Please note that AnsiString file tag values are converted to UTF-16LE when referenced in a search query string. To minimize the chance of string-conversion-related issues, it is recommended that applications only store ASCII characters in AnsiString-typed file tags, and prefer String-typed file tags (created using set_file_tag_as_string) in all other cases.

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

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