Cogent C API and Utilities : Version 6.4
	Cascade TextLogger Functions

`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.

`ST_STATUS LG_Enable(`	IP_Task*	`myself`,
	IP_Task*	`textlog`,
	char*	`retbuf`,
	int	`buflen`,
	int	`nlabels`,
	char**	`labels)`;


LG_Empty		LG_Exit

LG_Enable

Syntax

Arguments

Returns

Description

See Also

`LG_Enable`