LG_Enable
LG_Enable — activates a log or group.
Syntax
#include <cogent.h>
ST_STATUS LG_Enable( | IP_Task* | myself, |
| | IP_Task* | textlog, |
| | char* | retbuf, |
| | int | buflen, |
| | int | nlabels, |
| | char** | labels); |
Arguments
- myself
- A
pointer to this task's IP_Task
structure normallly generated by a call to IP_NserveInit.
- textlog
- A
pointer to the Cascade TextLogger's IP_Task
structure, normally generated by a call to IP_TaskFindName.
- retbuf
- A
pointer to a character buffer to hold the return from the
call.
- buflen
- The
length of retbuf, in bytes.
- nlabels
- The
number of labels (log or group names) referenced in the
labels argument.
- labels
- An
array of char*, each of which is a pointer to a string
containing a log or group name.
Returns
ST_OK on success. Otherwise
ST_ERROR, and the
retbuf will contain a more detailed error
message (see enable in the
Cascade TextLogger documentation). If the return value is
ST_OK, the retbuf
may not contain useful information.
Description
This function lets you
reactivate a disabled log or group. A log or group is
automatically enabled when the LG_Log or
LG_Group
function is first called, or when a log or group
command is first given. This function corresponds to the
Cascade TextLogger enable
command.
