Edit

Share via

NtClose function (winternl.h)

  • Article
  • 02/22/2024

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

Syntax

__kernel_entry NTSTATUS NtClose(
  [in] HANDLE Handle
);

Parameters

[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
STATUS_SUCCESS
 The handle was closed.

Remarks

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.

Requirements

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