[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETOBJSEC()
 Sets the security of a bindery object
------------------------------------------------------------------------------
 Syntax

     NNETOBJSEC(<cObjName>,<nObjType>,<nSafe>,
        [<cServer>|<nConId>]) --> lSuccess

     Netware: 2.2 and 3.11

 Arguments

     <cObjName>  Designates the name of the object for which the security
     is modified.

     <nObjType>  Designates a numeric value that specifies the object
     type.  The header file CTNNET.CH contains symbolic constants for the
     object types defined by Novell for use in conjunction with the bindery
     functions of CA-Clipper Tools.

     <nSafe>  Designates the new value for the object security.  This
     value specifies the rights required to find (read) or to modify (write)
     the object in the bindery.  The settings are defined with a bit-coded
     mask.  The low-ordered bits control the read access; the high-ordered
     bits control the write access to the bindery object.

     Table 18.4:  Values for Object Security
     ------------------------------------------------------------------------
     Value  Hex  Bin     Definition
     ------------------------------------------------------------------------
     0      0    0000    Access allowed to all users
     1      1    0001    Access allowed to users who have logged in to the
                         file server
     2      2    0010    Access allowed to users who have logged in to the
                         file server with password
     3      3    0011    Access allowed to users who have logged in to the
                         file server as the supervisor or as a user who has
                         supervisor equivalence
     4      4    0100    Access only allowed to the network operating system
     ------------------------------------------------------------------------

     <cServer>  Designates the name of the file server that is used.
     Your workstation must be attached to <cServer>.

     <nConId>  Designates the connection ID of your workstation on
     <cServer>.

 Returns

     NNETOBJSEC() returns .T. if the new security value (<nSafe>) has been
     set successfully.

 Description

     Important!  NNETOBJSEC() is a low level bindery function and should
     be used only with extensive knowledge of the bindery concept and the
     Novell API.

     NOVELL NET OBJECT SECURITY
     NNETOBJSEC() allows you to modify the security of existing bindery
     objects.  For efficiency reasons numeric values for <nObjType> must be
     passed in the high-low format.  This function requires supervisor
     rights.

 Example

     Set the security of the user object MICK to 51 (hex 33):

     IF NNETOBJSEC('MICK',OBJ_USER,51)
        ? 'Security modified successfully!'
     ELSE
        ? 'Error!'
     ENDIF

See Also: NNETCRTOBJ() NNETPRPSEC()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson