Updated: April 25, 2014
Some functions in the library return a string into a buffer. These functions require that you pass in the size of the buffer when calling the function. If the buffer size is too small, the function returns the constant ROLEMANAGER_E_INSUFFICIENT_BUFFER and a parameter that indicates the required size for the buffer. The functions that may return this constant include the RoleEnvironmentGetConfigurationSetting Function, LocalResourceGetName Function, and LocalResourceGetRootPath functions.
A function that returns ROLE_ENVIRONMENT_E_INSUFFICIENT_BUFFER may be retried with a larger buffer. No other errors may be retried.