TagsDBRemoveTag
- Last UpdatedOct 29, 2026
- 2 minute read
This function removes an existing project tag from the tags database during run time.
|
Function |
Group |
Execution |
String Exp. |
Windows |
Windows Embedded |
IoT View |
Thin Clients |
Mobile Access |
|---|---|---|---|---|---|---|---|---|
|
TagsDBRemoveTag |
Tags Database |
Synchronous |
No |
Supported (see Notes below) |
Not supported |
Not supported |
Not supported |
Not supported |
Syntax
TagsDBRemoveTag( strTagName )
TagsDBRemoveTag ( strTagName )
strTagName
The name of the project tag to be removed.
Returned value
This function returns one of the following possible values:
|
Value |
Description |
|---|---|
|
-4 |
The specified tag does not exist in the tags database. |
|
-3 |
Wrong parameter type or inconsistent value. |
|
-2 |
Invalid number of parameters. |
|
-1 |
The function TagsDBBeginEdit was not executed successfully before this function was called. |
|
0 |
Function executed successfully. |
Notes
The following restrictions apply to the execution of this function:
-
The function can only be executed on the project server — it cannot be called by a Graphics Script, Screen Script, or Command animation running on a project client;
-
The function TagsDBBeginEdit must have been executed previously, in order to lock the tags database for editing; and
-
The function TagsDBEndEdit must be executed when the editing is finished, in order to release the tags database and resume normal runtime operations.
For more information about the Tags Database functions and examples of how to use them, see Using TagsDB functions to edit the tags database during run time.
Also, please note that executing this function does not completely remove the specified project tag from the tags database. That is not possible, due to how the database is maintained during run time. Instead, executing this function removes all uses of the specified tag in the project, so that they do not count against the tag limit on your runtime license, and then it reduces the tag to a single blank line in the database. Therefore, any time you execute this function to remove tags, you should stop the project as soon as it is practical to do so and then verify the project to remove the blank lines. For more information, see Verify the project.