[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETCRTOBJ()
 Creates a new bindery object
------------------------------------------------------------------------------
 Syntax

     NNETCRTOBJ(<cName>,[<nType>],[<nDynamic>],[<nSafe>],
        [<cServer>|<nConId>) --> lSuccess

     Netware: 2.2 and 3.11

 Arguments

     <cName>  Designates the name of the new bindery object.  Under
     Netware, object names can be up to 47 characters long.

     <nType>  Designates a numeric value that indicates the type of
     <cName>.  The header file CTNNET.CH contains symbolic constants for the
     object types defined by Novell for use with the bindery functions of
     CA-Clipper Tools.  The default value indicates the object type OBJ_USER.

     <nDynamic>  Designates whether the bindery object is static (0) or
     dynamic (1).  The default value is static (0).

     <nSafe>  Designates the value for the object security.  The value
     specifies the rights required to find (read) or to modify (write) the
     object in the bindery.  The settings are defined in 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.2:  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 Netware operating system
     ------------------------------------------------------------------------

     The default value for <nSafe> is 49 (31h).  The mask defines write
     access for supervisors and equivalents, and read access for all logged
     in users.

     <cServer>  Designates the name of the file server for which the
     bindery is accessed.  Your workstation must be attached to <cServer>.

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

 Returns

     NNETCRTOBJ() returns .T. if the new object has been created
     successfully.  If an error occurs, the Novell error code can be queried
     with the NNETERROR() function.

 Description

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

     NOVELL NET CREATE BINDERY OBJECT
     NNETCRTOBJ() allows you to create a new bindery object.  Supervisor
     rights are required.  For efficiency reasons, user defined object types
     must be passed in high-low format.

     For the definition of the security mask, the four bits for the write
     access must be followed by the four bits for the read access.  The
     resulting eight-bit string must be passed as decimal value for <nSafe>.

 Examples

     .  Create a static object of the type group under the name DEV:

        #include "ctnnet.ch"

        IF NNETCRTOBJ('DEV',OBJ_GROUP)
        ? 'Group created successfully!'
        ELSE
        ? 'Group could not be created!'
        ENDIF

     .  To create groups, use the NNETCRTGRP function in CA-Clipper
        Tools.

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