AllocateResourceTag

Allocates a resource tag for a particular resource

Local Servers:blocking
Remote Servers:N/A
Classification:3.x, 4.x, 5.x, 6.x
Service:Advanced

Syntax

  #include <nwadv.h>  
   
  LONG AllocateResourceTag  (  
     LONG    NLMHandle,   
     BYTE   *descriptionString,   
     LONG    resourceType); 
  

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.

descriptionString

(IN) Points to a string describing the resource tag.

resourceType

(IN) Specifies the type of resource tag desired.

Return Values

This function returns a resource tag if successful or a value of 0 if not successful.

Remarks

The resource tag is used as a parameter to other function calls which allocate resources, and in turn, used by the NetWare® Resource Management System. A list of resource types or resource tag signatures can be found in nwadv.h:

Resource Type

For Use With

AESProcessSignature

ScheduleNoSleepAESProcessEvent

ScheduleSleepAESProcessEvent

ConsoleCommandSignature

RegisterConsoleCommand

See Also

alloca, __qmalloc (NDK: Program Management), GetNLMHandle (NDK: NLM Threads Management)