Registers a resource tag signature for tracking.
#include <netware.h>
int RegisterTrackedResource (
void *NLMHandle,
uint32_t signature,
Cleanup_t cleanup,
const char *description);
(IN) Points to the handle of the NLM application for which a tracked resource is desired; the NLM handle is obtained by calling getnlmhandle.
(IN) Specifies the type of tracked resource desired. For the types defined the NetWare operating system, see Section 30.2, Resource Tag Signatures. Select a unique value for your resource tag.
(IN) Specifies the function to call when the tracked resource is unregistered.
(IN) Points to a string describing the resource tag. This string can be anything, and it is displayed on the NetWare Console Monitor and the Novell Remote Manager. It has a maximum length of 63 characters.
If successful, returns 0.
The RegisterTrackedResource function allows you to create a resource tag signature to use with your application. If one of your NLM applications using this tag fails to release all of its resources when it unloads, the operating system calls your cleanup function to finish the task.
The cleanup function must conform to the syntax of the following prototype:
typedef void (
*Cleanup_t)(
rtag_t rTag,
int forceFlag);
The parameters are used to specify the following.
(IN) Specifies a resource tag.
(IN) Not currently used. Set this to TRUE.