amarquee.library/QReleasePrivilegesOp           amarquee.library/QReleasePrivilegesOp

   NAME
    QReleasePrivilegesOp - Relinquish special privileges/abilities.

   SYNOPSIS
    #include 

    LONG QReleasePrivilegesOp(struct QSession * session, ULONG privBits)

   FUNCTION
    With this function you can give up your special permissions that
    were previously given you as the result of a call to QRequestPrivilegesOp.
    
   NOTE
    This function requires v45 of amarquee.library, and v1.45
    of AMarqueed.
    
   INPUTS
    session   - The session for which you wish to release privileges.
    privBits  - A bit-chord specifying which special priviliges you want
                to give up.  The following constants are currently available:

     To see which constants may be or'd together into privBits,
     read the QRequestPrivilegesOp documentation. 
                
   RESULTS
    Returns the assigned ID number of the access operation, or 0
    to indicate failure (due to memory shortage).  
    
    The server will always allow you to give up privileges, so 
    no further result checking should be necessary.  

   EXAMPLE
    LONG transID;
    
    /* Release the ability to kill other clients */
    if (transID = QReleasePrivilegesOp(session, QPRIV_KILLCLIENTS))
       printf("ReleasePrivileges op succeeded, was given id #%li\n",transID);
    else 
       printf("ReleasePrivileges op failed.  (no memory?)\n");

   AREXX EXAMPLE
    transID = QReleasePrivilegesOp(session, QPRIV_KILLCLIENTS)
    if (transID = 0) then say "Oops, transaction failed."

   SEE ALSO
    QGo, QRequestPrivilegesOp, QKillClientsOp