NWIsObjectInSet(3nw)


NWIsObjectInSet -- searches a property of type SET for a specified object

Synopsis

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

NWCCODE N_API NWIsObjectInSet (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 name of the object containing the property being searched.

objType
(IN) Specifies the object type of the object containing the property being searched.

propertyName
(IN) Points to the property name of the set being searched.

memberName
(IN) Points to the name of the bindery object being searched.

memberType
(IN) Specifies the bindery type of the member being searched.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8996
SERVER_OUT_OF_MEMORY

0x89EA
NO_SUCH_MEMBER

0x89EB
NOT_GROUP_PROPERTY

0x89EC
NO_SUCH_SEGMENT

0x89F0
WILD_CARD_NOT_ALLOWED

0x89FB
N0_SUCH_PROPERTY

Notices

NWIsObjectInSet requires Read access to the property SET.

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

NWIsObjectInSet does not expand members of type GROUP in an attempt to locate a specific member; objects must be explicitly in the group. For example, assume the following bindery objects and properties exist:

Object Property Property Value
JOAN    
SECRETARIES GROUP_MEMBERS JOAN's object ID
EMPLOYEES GROUP_MEMBERS SECRETARIES' objectID

 
 ------------------------------------------------------ 
| Object     |  Property     |  Property Value        | 
|------------|---------------|------------------------| 
| JOAN       |               |                        | 
|------------|---------------|------------------------| 
| SECRETARIES|  GROUP_MEMBERS|  JOAN's object ID      | 
|------------|---------------|------------------------| 
| EMPLOYEES  |  GROUP_MEMBERS|  SECRETARIES' objectID | 
|------------|---------------|------------------------| 

JOAN is not considered a member of EMPLOYEES; she is not explicitly listed in EMPLOYEES' GROUP_MEMBERS. In addition, the bindery does not check for recursive (direct or indirect) membership.definitions.

Services

Bindery

NCP calls

0x2222 23 67
Is Bindery Object In Set

References

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