AllocateUniqueString()

CHAR_TYPE* Chusov::String::AllocateUniqueString ( )

noexcept

Allocates and returns a unique string which is a representation of an UUID generated internally.

Template Parameters

CHAR_TYPE

is a type of the allocated buffer. Currently the template is defined only for CHAR_TYPE=char and CHAR_TYPE=wchar_t resolving to AllocateUniqueStringA and AllocateUniqueStringW respectively.

Returns

On success the function returns a pointer to an allocated buffer initialized by an UUID represented as a C string. Use FreeStringA to free the returned buffer after its usage. If the function fails it returns NULL. Use GetLastChsvError to get extended error information.

Remarks

The string is returned in format "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" plus the terminating zero as the last character.

See also

GetUniqueString;
AllocateUniqueTempFileName;
FreeString;
AllocateString;
AllocateAndFormatString.