SetHandleCount

The SetHandleCount function sets the number of file handles available to a process.

Windows NT/2000 and Windows 95/98: This function has no effect, because there is no explicit file handle limit for applications on these platforms.

Win32s: There are only 20 file handles available to a process by default; however you could use SetHandleCount to allow a process to use up to 255 file handles.

UINT SetHandleCount(
  UINT uNumber   // number of file handles needed
);

Parameters

uNumber

[in] Specifies the number of file handles needed by the application.

Return Values

Windows NT/2000 and Windows 95/98: This function simply returns the value specified in the uNumber parameter.

Win32s: The return value specifies the number of file handles actually available to the application. It may be fewer than the number specified by the uNumber parameter.

Remarks

Windows NT/2000 and Windows 95/98: The maximum number of files that an application can open is determined by the amount of available non-paged memory pool, because each open file handle requires non-paged memory.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Kernel32.lib.

See Also

File I/O Overview, File I/O Functions