Chapter 2: Understanding Structures, Constants, and Conventions
Output parameter strings
An application indicates the length of a string buffer by
setting an associated length parameter. If the length parameter
indicates that the buffer is not large enough to hold a null-terminated
output string, Client-Library routines return CS_FAIL.