AllocateResourceTag

Allocates a resource tag for a particular resource.

Library:LibC
Classification:NetWare OS
Service:NetWare Platform

Syntax

  #include <netware.h> 
   
  rtag_t AllocateResourceTag (
     void         *NLMHandle,
     const char   *description,
     uint32_t      signature);
  

Parameters

NLMHandle

(IN) Specifies the handle of the NLM application for which a resource tag is desired; the NLM handle is obtained by calling getnlmhandle.

description

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

signature

(IN) Specifies the type of resource tag desired. For the types, see Section 30.2, Resource Tag Signatures.

Return Values

If successful, returns a resource tag; otherwise, returns 0.

Remarks

The resource tag is used as a parameter to other function calls which allocate resources, and in turn, the NetWare operating system uses the tags to identify ownership or responsibility for those resources. For example, a call to Alloc requires a resource tag

See Also