[<<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