NWGetObjectDiskSpaceLeft

Returns the remaining disk space for a specified object

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  NWGetObjectDiskSpaceLeft  ( 
      NWCONN_HANDLE   conn,  
      nuint32         objID,  
      pnuint32        systemElapsedTime,  
      pnuint32        unusedDiskBlocks,  
      pnuint8         restrictionEnforced);
   

Pascal

   uses calwin32 
    
   Function NWGetObjectDiskSpaceLeft 
     (conn : NWCONN_HANDLE; 
      objID : nuint32; 
      systemElapsedTime : pnuint32; 
      unusedDiskBlocks : pnuint32; 
      restrictionEnforced : pnuint8 
   ) : NWCCODE; stdcall;
   

Parameters

conn
(IN) Specifies the NetWare server connection handle.
objID
(IN) Specifies the ID of the object in question.
systemElapsedTime
(OUT) Points to the time the NetWare server has been up.
unusedDiskBlocks
(OUT) Points to the number of blocks the NetWare server must allocate to a bindery object.
restrictionEnforced
(OUT) Points to a flag indicating whether the NetWare server operating system can limit disk resources:
  • 0x0000 Enforced
  • 0x00FF Not enforced

Return Values

These are common return values. See Return Values (Return Values for C).

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x89C6

NO_CONSOLE_PRIVILEGES

0x89FC

NO_SUCH_OBJECT

Remarks

NWGetObjectDiskSpaceLeft returns the systemElapsedTime parameter in approximately 1/18 second units and determines the amount of elapsed time between consecutive calls. When the systemElapsedTime parameter reaches 0xFFFF, it resets to zero.

NCP Calls