Export (0) Print
Expand All

CloseDesktop function

Closes an open handle to a desktop object.

Syntax


BOOL WINAPI CloseDesktop(
  _In_  HDESK hDesktop
);

Parameters

hDesktop [in]

A handle to the desktop to be closed. This can be a handle returned by the CreateDesktop, OpenDesktop, or OpenInputDesktop functions. Do not specify the handle returned by the GetThreadDesktop function.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The CloseDesktop function will fail if any thread in the calling process is using the specified desktop handle or if the handle refers to the initial desktop of the calling process.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

CreateDesktop
Desktops
OpenDesktop
OpenInputDesktop
Window Station and Desktop Functions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft