NWAddObjectToSet(3nw)


NWAddObjectToSet -- adds member to bindery property of type SET

Synopsis

   #include <nwbindry.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWAddObjectToSet (NWCONN_HANDLE conn, pnstr8 objName, nuint16 objType, pnstr8 propertyName, pnstr8 memberName, nuint16 memberType);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare® server connection handle.

objName
(IN) Points to the new SET object name of set.

objType
(IN) Specifies the SET object type.

propertyName
(IN) Points to the set's property name.

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

0x0000
SUCCESSFUL

0x8996
SERVER_OUT_OF_MEMORY

0x89E8
WRITE_PROPERTY_TO_GROUP

0x89E9
MEMBER_ALREADY_EXISTS

0x89EA
NO_SUCH_MEMBER

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

Notices

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

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

NWAddObjectToSet searches consecutive segments of the property's value for an open slot where it can record the unique bindery object identification of the new member. It then records the bindery object identification in the first available slot. If NWAddObjectToSet finds no available slot, it creates a new segment, writes the new member's unique bindery object identification into the first slot of the new segment, and fills the rest of the segment with zeros.

Services

Bindery

NCP calls

0x2222 23 65
Add Bindery Object To Set

References

NWDeleteObjectFromSet(3nw), NWIsObjectInSet(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.