NWScanVolDiskRestrictions2

Returns a list of the disk restrictions for a volume

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Volume

Syntax

   #include <nwvol.h> 
   or 
   #include <nwcalls.h> 
    
   N_EXTERN_LIBRARY( NWCCODE ) NWScanVolDiskRestrictions2  ( 
      NWCONN_HANDLE                conn,  
      nuint8                       volNum,  
      pnuint32                     iterHnd,  
      NWVOL_RESTRICTIONS  N_FAR   *volInfo);

Pascal Syntax

   uses calwin32 
    
   Function NWScanVolDiskRestrictions2 
     (conn : NWCONN_HANDLE; 
      volNum : nuint8; 
      iterhandle : pnuint32; 
      Var volInfo : NWVOL_RESTRICTIONS 
   ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
volNum
(IN) Specifies the volume number for which to return the restrictions.
iterHnd
(OUT) Points to the sequence number to use in the search (set to 0 initially).
volInfo
(OUT) Points to NWVOL_RESTRICTIONS.

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x8998

VOLUME_DOES_NOT_EXIST

Remarks

NWScanVolDiskRestrictions2 replaces NWScanVolDiskRestrictions. The new function uses a larger structure for the volume restrictions that allows up to 16 restrictions per volume.

NOTE:Calling NWScanVolDiskRestrictions when you have more than 12 restrictions per volume causes random failures. For this reason, call NWScanVolDiskRestrictions2 exclusively.

The information returned in NWVOL_RESTRICTIONS contains the object restrictions that have been made for the volume. All restrictions are returned in 4K blocks. If the restriction is greater than 0x40000000 on a 3.1 server or 0x80000000 on a 4.x and above server, the object has no restrictions.

IMPORTANT:NWScanVolDiskRestrictions2 is called iteratively to retrieve information on all disk space restrictions. The number of entries is returned in the volInfo.numberOfEntries field. This value must be added to the previous iterHnd to obtain the value for the next iterative call.

NCP Calls