ReserveABreakpointRTag

Reserves the specified resource tag for a breakpoint.

Library:LibC

Classification:NetWare OS

Service:NetWare Platform

Syntax

  #include <netware.h> 
   
  int ReserveABreakpointRTag (
     rtag_t   rTag);

Parameters

rTag: (IN) Specifies the resource tag to use in reserving a breakpoint.

Return Values

If successful, returns a handle to the reserved breakpoint that is used to call CSetABreakpoint.

Remarks

After you reserved a breakpoint, you need to set up a breakpoint. See the sample code below.

See Also

Example

The following sample code shows how to set a dynamic breakpoint in your code.

  // before setting the breakpoint
  static rtag_t   rtag = NULL;
  
  if (!(rtag = AllocateResourceTag(myhandle, "My breakpoint",
      BreakpointSignature)))
      ERROR
  
  // setting the bereakpoitint b;
  
  if ((b = ReserveABreakpointRTag(rtag)) == -1)
      ERROR
     CSetABreakpoint(b, breakaddress, 1, sizeof(LONG)); 
  
  // clearing the breakpointUnReserveABreakpoint( b );