NWAddObjectToSet

Adds a member to a bindery property of type SET

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  NWAddObjectToSet  ( 
      NWCONN_HANDLE       conn,  
      const nstr8 N_FAR  *objName,  
      nuint16             objType,  
      const nstr8 N_FAR  *propertyName,  
      const nstr8 N_FAR  *memberName,  
      nuint16             memberType);
   

Pascal

   uses calwin32 
    
   Function NWAddObjectToSet 
     (conn : NWCONN_HANDLE; 
      const objName : pnstr8; 
      objType : nuint16; 
      const propertyName : pnstr8; 
      const memberName : pnstr8; 
      memberType : nuint16 
   ) : NWCCODE; stdcall;
   

Parameters

conn
(IN) Specifies the NetWare® server connection handle.
objName
(IN) Points to the new SET object name.
objType
(IN) Specifies the SET object type.
propertyName
(IN) Points to the property name of the set.
memberName
(IN) Points to the name of the bindery object being added to the set.
memberType
(IN) Specifies the bindery object type of the member being added.

Return Values

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

0x0000

SUCCESSFUL

0x8996

SERVER_OUT_OF_MEMORY

0x89E8

WRITE_PROPERTY_TO_GROUP

0x89E9

MEMBER_ALREADY_EXISTS

0x89EA

NO_SUCH_MEMBERS

0x89EB

NOT_GROUP_PROPERTY

0x89EC

NO_SUCH_SEGMENT

0x89F0

WILD_CARD_NOT_ALLOWED

0x89F8

NO_PROPERTY_WRITE_PRIVILEGE

0x89FB

NO_SUCH_PROPERTY

0x89FC

NO_SUCH_OBJECT

0x89FE

BINDERY_LOCKED

0x89FF

HARDWARE_FAILURE

Remarks

A client must have write access to the SET property to call NWAddObjectToSet.

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

NWAddObjectToSet searches consecutive segments of the property value for an open slot where it can record the unique bindery object identification of the new member and records the bindery object identification in the first available slot. If NWAddObjectToSet finds no available slot, a new segment is created, the new unique bindery object identification of the member is written into the first slot of the new segment, and the rest of the segment is filled with zeros.

NCP Calls

See Also

NWDeleteObjectFromSet, NWIsObjectInSet