Return Codes

The functions in the Service Hosting Runtime Native Library return a generic success or failure status. To test for success, use the SUCCEEDED macro. To test for failure, use the FAILED macro.

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.