COSIM_LOGWINDOW_CREATE

 cosim_logwindow cosim_logwindow_create(const char *name); 

Header File

cosim_log.h

Description

This function creates an Application Monitor log window. This function may be called from anyplace in an application.

Arguments

The argument for cosim_logwindow_create is as follows:

const char *name

A programmer defined name. This name may be any text string. It is used to visually identify a specific log window when using the Application Monitor.

Return Value

A pointer to the created log window. This return value may subsequently be used as an argument to the functions cosim_logwindow_write and cosim_logwindow_fwrite.

Returns NULL (and sets co_errno to CO_ELOGWINDOW_NOT_INITIALIZED) if a previous call to cosim_logwindow_init failed or cosim_logwindow_init was not called in the configuration function.

Also returns NULL (and sets co_errno to CO_ENULL_PTR) if a NULL name pointer ("") was given as an argument.