NWIsObjectInSet

Searches a property of type SET for a specified object

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 NWIsObjectInSet ( 
      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 NWIsObjectInSet 
     (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 name of the object containing the property being searched.
objType
(IN) Specifies the 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

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

0x89EA

NO_SUCH_MEMBER

0x89EB

NOT_GROUP_PROPERTY

0x89EC

NO_SUCH_SEGMENT

0x89F0

WILD_CARD_NOT_ALLOWED

0x89FB

N0_SUCH_PROPERTY

Remarks

NWIsObjectInSet requires Read access to the SET property.

The objName, objType, propertyName, memberName, and memberType parameters 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

The object ID of JOAN

EMPLOYEES

GROUP_MEMBERS

The object ID of SECRETARIES

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

See Object Type.

NCP Calls

See Also

NWAddObjectToSet, NWDeleteObjectFromSet