Name
hw_GetErrorName -- compose error string into memory buffer (V5.0)
Synopsis
void hw_GetErrorName(int error, STRPTR buf, int size);
Function
This function composes a full error message including extended error information set via hw_SetErrorString() or hw_SetErrorCode() into a memory buffer. You have to pass a pointer to a memory buffer in parameter 2 and the size of this buffer in parameter 3. Hollywood will then copy a null-terminated string to this memory buffer. Some error messages are quite lengthy so make sure that the buffer you pass here is at least 1 kilobyte in size.

Designer compatibility
Supported since Designer 4.0

Inputs
error
error code whose message text you want to retrieve
buf
pointer to a memory buffer
size
total size of the memory buffer in bytes

Show TOC