Function Reference


Opens the specified desktop object

#include <WinAPISys.au3>
_WinAPI_OpenDesktop ( $sName [, $iAccess = 0 [, $iFlags = 0 [, $bInherit = False]]] )


$sName The name of the desktop to be opened. Desktop names are case-insensitive. This desktop must belong to
the current window station.
$iAccess [optional] The access to the desktop. This parameter can be one or more of the following values.
$iFlags [optional] The optional flags. It can be zero or the following value.
$bInherit [optional] Specifies whether inherites the handle by a processes, valid values:
    True - The processes created by this process will inherit the handle.
    False - The processes do not inherit this handle (Default).

Return Value

Success: Handle to the opened desktop.
Failure: 0, call _WinAPI_GetLastError() to get extended error information.


When you are finished using the desktop, call the _WinAPI_CloseDesktop() function to close it.



See Also

Search OpenDesktop in MSDN Library.