User Guide


String Handle API

Many API calls require names to identify API objects. String handles are pointers to names. They enable efficient handling of named objects in run time and make collected traces data more compact.
Use This Primitive
To Do This
__itt_string_handle *ITTAPI
( const char *name)
Use this function to create and return a handle value that can be associated with a string. Consecutive calls to
with the same name return the same value. The set of string handles is expected to remain static during the application's execution time, therefore, there is no mechanism to destroy a string handle. Any string handle can be accessed by any thread in the process, regardless of which thread created the string handle. This call is thread-safe.
The input string

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at