NWWritePropertyValue

Writes the property data of a bindery object on the NetWare server associated with the given connection handle

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Bindery

Syntax

C

   #include <nwbindry.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API  NWWritePropertyValue  ( 
      NWCONN_HANDLE   conn,  
      const nstr8 N_FAR   *objName,  
      nuint16              objType,  
      const nstr8 N_FAR   *propertyName,  
      nuint8               segmentNum,  
      const nuint8 N_FAR  *segmentData,  
      nuint8               moreSegments);

Pascal

   uses calwin32 
    
   Function NWWritePropertyValue 
     (conn : NWCONN_HANDLE; 
      const objName : pnstr8; 
      objType : nuint16; 
      const propertyName : pnstr8; 
      segmentNum : nuint8; 
      const segmentData : pnuint8; 
      moreSegments : nuint8 
   ) : NWCCODE; stdcall;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
objName
(IN) Points to the name of the object.
objType
(IN) Specifies the type of the object.
propertyName
(IN) Points to the property name of the object.
segmentNum
(IN) Specifies the segment number of the 128-byte data blocks (set to 1 initially).
segmentData
(IN) Points to the 128-byte buffer containing the data.
moreSegments
(IN) Specifies whether more segments are being written:
  • 0xFF More segments are being written
  • 0x00 The last segment is being written

Return Values

These are common return values. See Return Values (Return Values for C).

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x8996

SERVER_OUT_OF_MEMORY

0x89E8

WRITE_PROPERTY_TO_GROUP

0x89EC

NO_SUCH_SEGMENT

0x89F0

WILD_CARD_NOT_ALLOWED

0x89F8

NO_PROPERTY_WRITE_PRIVILEGE

0x89FB

N0_SUCH_PROPERTY

0x89FC

NO_SUCH_OBJECT

0x89FE

BINDERY_LOCKED

0x89FF

HARDWARE_FAILURE

Remarks

A client must have Write access to the property to call NWWritePropertyValue.

When NWWritePropertyValue returns, any remaining segments are truncated and the extra segments discarded.

Create property value segments sequentially. Before segment N can be created, all segments from 1 to N–1 must be created. However, once all segments of a property value have been established, segments can be written at random. If the segment data is longer than 128 bytes, it is truncated and the 128th byte is NULL.

NOTE:Keep property values to a single segment (128 bytes) to improve bindery efficiency.

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

See Object Type.

See Activity Coordination.

NCP Calls

See Also

NWReadPropertyValue