GetAvailableUserDiskSpace

Returns the disk space available to a user in blocks

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.x, 4.x, 5.x, 6.x
Platform:NLM
SMP Aware:No
Service:Volume

Syntax

   #include <nwdir.h> 
    
    int GetAvailableUserDiskSpace (  
       char   *pathName, 
       LONG   *availableSpace);

Parameters

pathName

(IN) Points to the directory pathname that the available disk space is to be returned for.

availableSpace

(OUT) Points to the remaining disk space, in blocks, available to the user in the specified directory.

Return Values

Value

Hex

Constant

0

(0x00)

ESUCCESS

NetWare Error

UNSUCCESSFUL

Remarks

This function returns the amount of disk space (in blocks) in the specified directory for the current connection. The disk space returned also includes purgeable blocks. The amount of space available is limited in three ways:

  • User space restriction (the "user" is specified by the current connection)

  • Directory space restriction

  • Physical space left on the volume

GetAvailableUserDiskSpace is not supported in a NetWare 2.x environment. On remote servers running NetWare 2.x, this function returns error code 251 (ERR_UNKNOWN_REQUEST).

SetCurrentNameSpace sets the name space which is used for parsing the path input to this function.

NOTE:For NetWare versions before 4.x, this function only works with DOS name space for remote servers.

See Also

DeleteUserSpaceRestriction, ReturnSpaceRestrictionForDirectory