NWScanObject

Searches for a bindery object 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 NWScanObject ( 
      NWCONN_HANDLE       conn,  
      const nstr8 N_FAR  *searchName,  
      nuint16             searchType,  
      pnuint32            objID,  
      pnstr8              objName,  
      pnuint16            objType,  
      pnuint8             hasPropertiesFlag,  
      pnuint8             objFlags,  
      pnuint8             objSecurity);

Pascal

   uses calwin32 
    
   Function NWScanObject 
     (conn : NWCONN_HANDLE; 
      const searchName : pnstr8; 
      searchType : nuint16; 
      objID : pnuint32; 
      objName : pnstr8; 
      objType : pnuint16; 
      hasPropertiesFlag : pnuint8; 
      objFlags : pnuint8; 
      objSecurity : pnuint8 
   ) : NWCCODE; stdcall;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
searchName
(IN) Points to the object name for which to search (wildcards are allowed).
searchType
(IN) Specifies the object type used in the search (wildcards are allowed).
objID
(IN/OUT) Points to the last object ID (-1 is assumed if no value is specified).
objName
(OUT) Points to the name of the next matching object (optional).
objType
(OUT) Points to the 2-byte type of the next matching object (optional).
hasPropertiesFlag
(OUT) Points to the properties flag (optional):
  • 0x00 Matching object has no properties
  • 0xFF Matching object has properties
objFlags
(OUT) Points to the object flag byte (optional):
  • BF_STATIC
  • BF_DYNAMIC
objSecurity
(OUT) Points to the security mask of the matching object (optional).

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

0x89EF

INVALID_NAME

0x89FC

NO_SUCH_OBJECT

0x89FE

BINDERY_LOCKED

0x89FF

HARDWARE_FAILURE

Remarks

NWScanObject iteratively scans the bindery for all objects matching both the objName and objType parameters.

Upon return, the objID parameter receives a number to be used as the object identification for the next call.

The requesting process must be logged in to the NetWare server and have Read access to the bindery object.

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