[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
NNETWRTITM()
Writes a segment of an item property
------------------------------------------------------------------------------
Syntax
NNETWRTITM(<cObjName>,[<nObjType>],<cProperty>,
<cPropValue>,[<nSegment>],[<lDelete>],
[<cServer>|<nConId>]) --> lSuccess
Netware: 2.2 and 3.11
Arguments
<cObjName> Designates the name of the bindery object that is
processed.
<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 object value OBJ_USER.
<cProperty> Designates the name of an item property of the object
<cObjName>.
<cPropValue> Designates the value that is stored. The value must
be passed as a character string of up to 128 characters.
<nSegment> Designates the segment of <cProperty> in which
<cPropValue> is written. The default value is the first segment.
<lDelete> Designates whether the segments following <nSegment> are
deleted (.T.) or saved (.F.). The default value (.F.) saves the
segments that follow <nSegment>.
<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
NNETWRTITM() returns .T. if the operation was completed successfully.
If an error occurs, the Novell error code can be queried with the
NNETERROR() function.
Description
Important! NNETWRITITM() is a low level bindery function and should
be used only with extensive knowledge of the bindery concept and the
Novell API.
NOVELL NET WRITE PROPERTY ITEM
Internally, Novell Netware defines two different property types: item
and set properties. Item properties consist of segments that can accept
up to 128 characters. The number of segments within an item property
can vary.
A typical example of an item property is the IDENTIFICATION property
that contains a user or user group's full name (unlike the login name).
NNETWRTITM() allows you to write information to a segment of an item
property.
The parameters <cName> and <cType> specify the object that is
processed. <cProperty> is the name of the property. The property must
have been created before (for example, with NNETCRTPRP()). <cPropValue>
is the character string that is written to <nSegment> of <cProperty>.
With the parameter <lDelete>, you can determine whether segments that
follow <nSegment> are deleted (.T.) or not (.F.).
With the parameters <cServer> or <nConId>, the bindery of any attached
server can be accessed. The connection ID of a server is returned by
NNETATTACH() or NNETLOGIN().
To achieve results with NNETWRTITM(), sufficient bindery and property
access rights are required. The necessary property access rights depend
on the property security of the property that is modified. For
efficiency reasons, user defined object types must be passed in the high-
low format.
Example
Set the full name for user MICK:
IF NNETWRTITM('MICK',,'IDENTIFICATION','Michael Smith')
? 'Full name set successfully!'
ELSE
? 'Full name could not be set!'
ENDIF
See Also:
NNETADDSET()
NNETCRTPRP()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson