LG_Disable
LG_Disable — renders a log or group inactive.
Syntax
#include <cogent.h>
ST_STATUS LG_Disable( | 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 disable in the
Cascade TextLogger documentation). If the return value is
ST_OK, the retbuf
may not contain useful information.
Description
This function lets you
inactivate any number of logs or groups. This function
corresponds to the Cascade TextLogger disable
command.
