NWReadPropertyValue(3nw)

Synopsis

   #include <nwbindry.h> 
   or 
   #include <nwcalls.h> 
   
 
   NWCCODE N_API NWReadPropertyValue 
     (NWCONN_HANDLE   conn, 
      pnstr8          objName, 
      nuint16         objType, 
      pnstr8          propertyName, 
      nuint8          segmentNum, 
      pnuint8         segmentData, 
      pnuint8         moreSegments, 
      pnuint8         flags); 

Description

conn

(IN) Specifies the NetWare server connection handle.

objName

(IN) Points to the object name containing the property.

objType

(IN) Specifies the object type of the object containing the property.

propertyName

(IN) Points to the name of the property whose information is being retrieved.

segmentNum

(IN) Specifies the segment number of the data to be read (128-byte blocks).

segmentData

(OUT) Points to the 128-byte buffer receiving the property data.

moreSegments

(OUT) Points to a flag. Returns 0x00 if there are no more segments to be read; otherwise, returns 0xFF.

flags

(OUT) Points to the property type (optional): BF_ITEM or BF_SET.

Return values

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x8988

INVALID_FILE_HANDLE

0x8993

NO_READ_RRIVILEGES

0x8996

SERVER_OUT_OF_MEMORY

0x89EC

NO_SUCH_SEGMENT

0x89F0

WILD_CARD_NOT_ALLOWED

0x89F1

INVALID_BINDERY_SECURITY

0x89F9

NO_PROPERTY_READ_PRIVILEGES

0x89FB

N0_SUCH_PROPERTY

0x89FC

NO_SUCH_OBJECT

0x89FE

BINDERY_LOCKED

0x89FF

HARDWARE_FAILURE

Notices

NWReadPropertyValue iteratively reads property values with more than 128 bytes of data. segmentNum should be set to 1 to read the first data segment of a property. Each subsequent function should increment segmentNum until moreSegments is set to 0 or until NO_SUCH_SEGMENT is returned.

objName, objType, and propertyName must uniquely identify the property and cannot contain wildcard characters.

flags indicates the property's type and whether the property is dynamic. A dynamic property is created and deleted frequently. Dynamic properties are deleted from the bindery when the NetWare server is reinitialized. flags is optional. If the parameter is not desired in the return, a NULL can be substituted.

The property type indicates the type of data a property value contains. The SET property type indicates that the property's value contains a set of bindery object identifications. The bindery attaches no significance to the contents of a property value if the property is of type ITEM.

If the property is of type SET, the data returned in segmentData is an array of bindery object IDs.

The bindery makes no attempt to coordinate activities among multiple stations that concurrently read or write data to a single property. One station might read a partially updated property and get inconsistent data if the property's data extends across multiple segments. If this presents a problem, coordination on Reads and Writes must be handled by application programs. Logical record locks can be used to coordinate activities among applications.

Services

NCP calls

0x2222

23

61

Read Property Value

 
 ----------------------------------------- 
| 0x2222|  23|  61|  Read Property Value | 
|-------|----|----|----------------------| 

References