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

     NNETCRTPRP(<cObjName>,[<nObjType>],<cPropName>
        [<nFlag>],[<nSafe>],[<cServer>|<nConId>])
         --> lSuccess

     Netware: 2.2 and 3.11

 Arguments

     <cObjName>  Designates the name of the object for which a new
     property is created.

     <nObjType>  Designates a numeric value that indicates the object
     type.  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.

     <cPropName>  Designates the name of the new property.  The name can
     be up to 15 characters long.

     <nFlag>  Designates the value for the property flag.  With the
     property flag, two property characteristics can be set.  With bit 1 you
     can determine if the property is static (bit 1 = 0) or dynamic (bit
     1=1).  Bit 2 specifies an item (bit 2 = 0) or a set (bit 2 = 1)
     property.  The following table contains possible values for <nFlag>:

     Table 18.3:  Possible property flags
     ------------------------------------------------------------------------
     Value   Sym. Con.    Definition
     ------------------------------------------------------------------------
     0       PRP_ITEM     Static item property
     1                    Dynamic item property
     2       PRP_SET      Static set property
     3                    Dynamic set property
     ------------------------------------------------------------------------

     Symbolic constants can be found in the header file CTNNET.CH.  The
     default value for <nFlag> is 0.

     <nSafe>  Designates the value for the property security.  For more
     information, see the description of the function NNETCRTOBJ(). The
     default value is 49 (31h).

     <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

     NNETCRTPRP() returns .T. if the new property <cPropName> has been
     created successfully.  If an error occurs, the Novell error code can be
     queried with the NNETERROR() function.

 Description

     Important!  NNETCRTPRP() 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 PROPERTY
     NNETCRTPRP() allows you to create a new property for a bindery object.
     Sufficient bindery and object access rights are required.  The necessary
     object access rights depend on the object security of the object that is
     manipulated.  For efficiency reasons, user defined object types must be
     passed in the high-low format.

 Examples

     .  The property GROUP_MEMBERS is added to the group DEV.  This
        property is defined by Novell and must be created as set property:

        #include "ctnnet.ch"

        IF NNETCRTPRP('DEV',OBJ_GROUP,'GROUP_MEMBERS',PRP_SET)
        ? 'Property created successfully!'
        ELSE
        ? 'Property could not be created!'
        ENDIF

     .  To add a group, use the NNETADDGRP() function in CA-Clipper
        Tools.

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