ScanUserSpaceRestrictions

Returns information about users’ space restrictions on a volume

Local Servers:blocking
Remote Servers:blocking
Classification:3.x, 4.x, 5.x, 6.x
SMP Aware:No
Service:File System

Syntax

   #include <nwdir.h> 
    
    int ScanUserSpaceRestrictions (  
       int     volumeNumber, 
       LONG   *sequenceNumber, 
       LONG    numberOfTrusteesToReturn, 
       LONG   *answerArea, 
       LONG   *numberOfTrusteesReturned);
   

Parameters

volumeNumber

(IN) Specifies the volume number of the volume to be searched (0-63 for NetWare 3.1 and later; 0-31 for previous versions).

sequenceNumber

(IN/OUT) The initial search requires a 0 as input; after the initial search, the sequence number is incremented automatically within the function so the user only needs to initialize once.

numberOfTrusteesToReturn

(IN) Specifies the number of trustees to scan for.

answerArea

(OUT) Points to the buffer in which to place the result (returned by numberOfTrusteesReturned).

numberOfTrusteesReturned

(OUT) Returns the number of trustees for which space restriction information has been retrieved.

Return Values

Value

Hex

Constant

0

(0x00)

ESUCCESS

152

(0x98)

ERR_VOLUME_DOES_NOT_EXIST

Remarks

An application can use this function to return information about space restrictions for trustees. The function scans for as many trustees as specified by the numberOfTrusteesToReturn parameter.

The answerArea parameter points to an array of structures. Each structure has the following format:

      LONG   trusteeID;  
      LONG   restriction; 
   

The restriction field contains the space restriction in 4K blocks.

The CWV is used if the input volumeNumber is set to -1.

See Also

AddUserSpaceRestriction, DeleteUserSpaceRestriction