Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- NetLib for Clipper, Version 6.0 - n_b_prdel( <cobject>, <ntype>, <cproperty> ) http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
N_B_PRDEL( <cObject>, <nType>, <cProperty> )


Parameters

<cObject>
Name of an object.

<nType>
Object type.

<cProperty>
Name of a property to remove from the object.


Returns

Logical true if successful.

If the property does not exist, or if the current user does not have 
the correct write access level, the function will return false. 
N_ERROR() will return the NetWare error code.


Description

The specified property will be removed from the object. <nType> 
specifies the object type.

Value         Object type
 1            User
 2            Group
 3            Print queue
 4            File server
 6            Gateway
 7            Print server
38            Remote bridge

<cProperty> is the name of the property to delete.Listed below are some 
common item and set properties.

Item Properties
Name                   Description
ACCOUNT_BALANCE        User's usage balance on
                       server for various
                       services.

IDENTIFICATION         Full name (usually attached
                       to user or group objects).

NET_ADDRESS            Twelve-byte Internet
                       address (usually attached 
                       to server objects).

PASSWORD               Generally encrypted.

Q_DIRECTORY            Path to a print queue. Must
                       be less than 128
                       characters.

Set Properties
Name                  Owner        Member
GROUPS_I'M_IN         User         Groups an
                                   object belongs
                                   to. Usually 
                                   attached to
                                   user or group
                                   objects.

GROUP_MEMBERS         Group        Members of a
                                   user group.
                                   Usually
                                   attached to
                                   group objects.

                                   Note that for
                                   every entry in
                                   a GROUP_MEMBERS
                                   set, there is a
                                   corresponding
                                   entry in a 
                                   GROUPS_I'M_IN
                                   set.

OPERATORS             File server  Console
                                   operators.

Q_OPERATORS           Print queue  User/group who
                                   can reorder or
                                   delete any job
                                   in the queue.

Q_SERVERS             Print queue  Print server
                                   that can 
                                   service jobs in
                                   the queue.

Q_USERS               Print queue  User/group who
                                   can place jobs
                                   in the queue. 
                                   Usually
                                   EVERYONE.

SECURITY_EQUALS       User         User/group with
                                   same security
                                   level.


Example

/* Prepare to delete an object by first deleting
   its properties. Note  You should unlink the
   object from all sets before deleting set
   properties. * /

LOCAL aProperties := {}, i
.
.     // Unlink from sets. See N_B_UNLINK()
.
N_B_PRSCAN('IMGONE',1,@aProperties) // Clipper 5.x
FOR i = 1 TO LEN(aProperties)
   N_B_PRDEL('IMGONE', 1, aProperties[i])
NEXT



See Also: N_B_PRSCAN() N_B_PRTYPE() N_B_UNLINK()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson