NWScanProperty

Scans the given bindery object for properties matching the property name

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 NWScanProperty ( 
      NWCONN_HANDLE       conn,  
      const nstr8 N_FAR  *objName,  
      nuint16             objType,  
      pnstr8              searchPropertyName,  
      pnuint32            iterHandle,  
      pnstr8              propertyName,  
      pnuint8             propertyFlags,  
      pnuint8             propertySecurity,  
      pnuint8             valueAvailable,  
      pnuint8             moreFlag);

Pascal

   uses calwin32 
    
   Function NWScanProperty 
     (conn : NWCONN_HANDLE; 
      const objName : pnstr8; 
      objType : nuint16; 
      searchPropertyName : pnstr8; 
      iterHandle : pnuint32; 
      propertyName : pnstr8; 
      propertyFlags : pnuint8; 
      propertySecurity : pnuint8; 
      valueAvailable : pnuint8; 
      moreFlag : pnuint8 
   ) : NWCCODE; stdcall;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
objName
(IN) Points to the object name of the set.
objType
(IN) Specifies the object type of the set.
searchPropertyName
(IN) Points to the property name for which to search (wildcards are allowed).
iterHandle
(IN/OUT) Points to the iteration handle to use when making repeated calls (if not specified, –1 is assumed).
propertyName
(OUT) Points to the name of the next matching property (up to 15 characters including the NULL terminator or NULL).
propertyFlags
(OUT) Points to the status flag (optional):
  • 0x00 BF_STATIC
  • 0x00 BF_ITEM
  • 0x01 BF_DYNAMIC
  • 0x02 BF_SET
propertySecurity
(OUT) Points to the security mask (optional).
valueAvailable
(OUT) Points to a flag indicating whether the property has value (optional):
  • 0x00 Property has no value
  • 0xFF Property has value
moreFlag
(OUT) Points to the more properties flag (optional):
  • 0x00 No more properties exist for object
  • 0xFF More properties exist

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

0x89F0

WILD_CARD_NOT_ALLOWED

0x89FB

NO_SUCH_PROPERTY

0x89FC

NO_SUCH_OBJECT

0x89FE

BINDERY_LOCKED

0x89FF

HARDWARE_FAILURE

Remarks

Upon return, the moreFlag parameter contains 0xFF if the matched property is not the last property, and the iterHandle parameter contains the number to use in the next call.

NWScanProperty requires Read access to the bindery object as well as the property.

The objName and objType parameters must uniquely identify the bindery object and cannot contain wildcard characters.

For parameters not desired in the return, NULL can be substituted. All parameter positions must be filled.

See Section 4.3, Security Rights Mask Values.

See Object Type.

See binscan.c for sample code.

NCP Calls

See Also

NWReadPropertyValue, NWWritePropertyValue