[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
  GetFreeSystemResources( nType ) -> <nPercentage>
------------------------------------------------------------------------------


 PARAMETER:

  <nType>  is the type of resource to be checked. This parameter can be one
           of the following values: 

            GFSR_SYSTEMRESOURCES Returns the percentage of free space for
             [0]                 system resources. 
            GFSR_GDIRESOURCES    Returns the percentage of free space for
             [1]                 GDI resources. GDI resources include device
                                 context handles, brushes, pens, regions,
                                 fonts and bitmaps. 
            GFSR_USERRESOURCES   Returns the percentage of free space for
             [2]                 USER resources. These resources include
                                 window and menu handles. 

 RETURNS:

  <nPercentage> is the percentage of free space for resources, if the
  function is successful. 


 DESCRIPTION:

  GetFreeSystemResources() returns the percentage of free space for system 
  resources. Since the return value from this function does not guarantee
  that an application will be able to create a new ( Windows! ) object,
  applications should not use this function to determine whether it will be
  possible to create it.


 EXAMPLE:


    +--------------------------------------------------------------+
    |  /* Display the available resource space */                  |
    |  MsgInfo( "Free System resources: % " + AllTrim( Str( ;      |
    |              GetFreeSystemResources( 0 ) ) ) + CRLF + ;      |
    |            "     GDI    resources: % " + AllTrim( Str(;      |
    |              GetFreeSystemResources( 1 ) ) ) + CRLF + ;      |
    |            "     User   resources: % " + AllTrim( Str(;      |
    |              GetFreeSystemResources( 2 ) ) ) + CRLF + CRLF ) |
    |                                                              |
    +--------------------------------------------------------------+


 SOURCE:  

  SOURCE\WINAPI\RESOURCE.C



See Also: GetFreeSpace
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson