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