ReturnResourceTag

Returns an allocated resource tag.

Library:LibC
Classification:NetWare OS
Service:NetWare Platform

Syntax

  #include <netware.h>
  
  int ReturnResourceTag (
     rtag_t   rTag,
     int      displayErrorsFlag);

Parameters

rtag

(IN) Specifies the resource tag to free.

displayErrorsFlag

(IN) Specifies whether an error message can be displayed if the function fails.

  • 0 indicates that no errors should be displayed.
  • 1 indicates that it is okay to display errors.

Return Values

If successful, returns 0.

Remarks

If a resource tag is used until an application unloads, the resource tag does not need to be returned. The unload process automatically frees all resource tags. Use the ReturnResourceTag function only if your application allocates a resource tag that it does not need for the life of the program.

WARNING:Do not call this function if you are not certain all resources on the tag have been cleaned up.

See Also

AllocateResourceTag