[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETSCNPRP()
 Scans a bindery object for a property
------------------------------------------------------------------------------
 Syntax

     NNETSCNPRP(<cObjName>,<nType>,<cPropMask>,[@]<nSeq>,
        [@<nFlag>],[@<nSafe>],[@<lValue>],
        [<cServer>|   <nConId>]) --> cPropName

     Netware: 2.2 and 3.11

 Arguments

     <cObjName>  Designates the name of the bindery object that is
     processed.

     <nType>  Designates the object type of <cObjName>.  The header file
     CTNNET.CH contains the symbolic constants for a number of object types.
     When you work with numeric values, NNETSCNPRP() expects the object type
     in the high-low format for efficiency reasons.

     <cPropMask>  Designates a search mask that is satisfied by the
     properties that are searched.  <cPropMask> can contain the wildcard
     characters "*" and "?".

     <nSeq>  Designates the sequence number (high-low format) of the last
     property that was found.  To start the search with the first property,
     <nSeq> must be designated -1.  If <nSeq> is passed by reference, the
     variable contains the sequence number of the property found after the
     function has been completed successfully.

     <nFlag>  Designates the property flag after the function has been
     completed successfully.  This parameter must be passed by reference.
     The following table contains the possible values for <nFlag>:

     Table 18.6:  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
     ------------------------------------------------------------------------

     <nSafe>  Designates the property security after the function has
     been completed successfully.  This parameter must be passed by
     reference.  The property security is an eight-bit number.  The four high-
     order bits control the security level for the property's write access;
     the four low-order bits control the property's read access.  A table for
     access levels can be found with the NNETCRTOBJ() function.

     <lValue>  Designates a logical value that indicates if the property
     has any values (.T.) or not (.F.).  This parameter must be passed by
     reference.

     <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

     NNETSCNPRP() returns the name of the property that is found.  If no
     property is found, the function returns an empty string.  If the
     parameters <nSeq>, <nFlag>, and/or <nSafe> are passed by reference,
     NNETSCNPRP() returns the sequence number, the property flag, property
     security, and a flag for value existence (see the arguments).

 Description

     Important!  NNETSCNPRP() is a low level bindery function and should
     be used only with extensive knowledge of the bindery concept and the
     Novell API.

     NOVELL NET SCAN PROPERTY
     NNETSCNPRP() allows you to scan a bindery object (<cObjName> and
     <nType>) for properties that satisfy a specified search mask
     (<cPropMask>).  To find the first property that matches the passed
     criterion, the parameter <nSeq> must be designated -1.  For a successive
     search, the sequence number must be passed by reference in order to use
     the sequence number of the found property at the next function call.
     With the parameters <cServer> or <nConId>, the bindery of any attached
     file server can be accessed.  The connection ID of a server is returned
     by NNETATTACH() or NNETLOGIN().

 Note

     .  The object type and sequence number are expected and/or
        returned in the high-low format (see the Introduction to this
        chapter).

 Example

     List all the properties of the bindery object SUPERVISOR:

     #include "ctnnet.ch"

     nSeq:=-1   // Start with 1st property
     WHILE .T.
     cName=NNETSCNPRP('SUPERVISOR',OBJ_USER,'*', @nSeq, ;
     @nFlag,@nSafe,@lValue)
     IF EMPTY(cName)
     EXIT
     ENDIF
     ? cName,nSeq,nFlag,nSafe,lValue
     ENDDO

See Also: NNETCRTPRP() NNETSCNBIN()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson