NtClose function (winternl.h)

Deprecated. Closes the specified handle. NtClose is superseded by CloseHandle.


__kernel_entry NTSTATUS NtClose(
  [in] HANDLE Handle


[in] Handle

The handle being closed.

Return value

The various NTSTATUS values are defined in NTSTATUS.H, which is distributed with the Windows DDK.

Return code Description
The handle was closed.


The NtClose function closes handles to the following objects.

  • Access token
  • Communications device
  • Console input
  • Console screen buffer
  • Event
  • File
  • File mapping
  • Job
  • Mailslot
  • Mutex
  • Named pipe
  • Process
  • Semaphore
  • Socket
  • Thread
Because there is no import library for this function, you must use GetProcAddress.


Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header winternl.h
Library ntdll.lib
DLL ntdll.dll