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