VLSsetUserErrorFile

Syntax

typedef enum {	 
 	VLS_NULL, VLS_STDOUT, VLS_STDERR
} VLS_ERR_FILE;	 
 	 
LS_STATUS_CODE 	VLSsetUserErrorFile(
 	VLS_ERR_FILE   msgFile,
 	char LSFAP     *filePath
);	 

Description

Configures the manner in which error messages are displayed.

This function configures the displaying of error messages to the user through the default error handlers. If you disable the default error handlers, you do not need to use this function.

NOTE   The default handling of error messages is as follows: Windows Pop up a Message Box. Unix Write to stderr.

You can alter this behavior by providing a file path, while keeping the other parameter (msgFile) VLS_NULL. If you provide both parameters, preference will be given to the msgFile.

Returns

The status code LS_SUCCESS is returned if successful. Otherwise, it will return the following error codes:

Error Code	Description
VLS_CALLING_ERROR	Could not open msgFile.

For a complete list of the error codes, see Licensing Library Error and Result Codes.