NWScanVolDiskRestrictions2(3nw)


NWScanVolDiskRestrictions2 -- returns list of disk restrictions for volume

Synopsis

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

NWCCODE N_API NWScanVolDiskRestrictions2 (NWCONN_HANDLE conn, nuint8 volNum, pnuint32 iterHnd, NWVOL_RESTRICTIONS N_FAR * volInfo);

Description

The parameters are as follows:

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. Initially must be set to 0.

volInfo
(OUT) Points to NWVOL_RESTRICTIONS.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8998
VOLUME_DOES_NOT_EXIST

Notices

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

When called with 4.01 version of NWU, NWScanVolDiskRestrictions2 always returns there are no restrictions.


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

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


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

Services

Volume

NCP calls

0x2222 22 32 Scan Volume's User Disk Restrictions

 
 0x2222   22   32   Scan Volume's 
                    User Disk 
                    Restrictions 

30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.