[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
NNETDELOBJ()
Deletes a bindery object
------------------------------------------------------------------------------
Syntax
NNETDELOBJ(<cName>,[<nType>],[<cServer>|<nConId>])
--> lSuccess
Netware: 2.2 and 3.11
Arguments
<cName> Designates the name of the bindery object that is deleted.
<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.
<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
NNETDELTOBJ() returns .T. if the object <cName> has been deleted
successfully. If an error occurs, the Novell error code can be queried
with the NNETERROR() function.
Description
Important! NNETDELOBJ() is a low level bindery function and should
be used only with extensive knowledge of the bindery concept and the
Novell API.
NOVELL NET DELETE BINDERY OBJECT
NNETDELOBJ() allows you to delete bindery objects. Users and user
groups can be deleted. With the parameters <cServer> or <nConId>, the
bindery of any attached server can be accessed. The connection ID of a
server can be determined with NNETATTACH() or NNETLOGIN().
Supervisor rights are required to delete a bindery object. For
efficiency reasons, user defined object types must be passed in the high-
low format.
Note
. CA-Clipper Tools has no high level function available to
delete users or user groups. Use NNETDELOBJ().
Examples
. Delete user GUEST:
IF NNETDELOBJ('GUEST')
? 'User has been deleted successfully!'
ELSE
? 'User could not be deleted!'
ENDIF
. Delete group DEV:
#include "ctnnet.ch"
IF NNETDELOBJ('DEV',OBJ_GROUP)
? 'Group has been deleted successfully!'
ELSE
? 'Group could not be deleted!'
ENDIF
See Also:
NNETCRTOBJ()
NNETDELPRP()
NNETERROR()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson