Location: Symbol Reference > Classes > TJwSecurityDesktops Class > TJwSecurityDesktops Methods > TJwSecurityDesktops.CreateDesktop Method
JWSCL Documentation
ContentsIndexHome
PreviousUpNext
TJwSecurityDesktops.CreateDesktop Method
Pascal
function CreateDesktop(const Name: TJwString; const DesktopFlags: TJwSecurityDesktopFlags; const aDesiredAccess: ACCESS_MASK; const aSecurityDescriptor: TJwSecurityDescriptor): TJwSecurityDesktop; virtual;
Parameters 
Description 
const DesktopFlags: TJwSecurityDesktopFlags 
Contains flags for desktop opening. See TJwSecurityDesktopFlags for more information  
const aSecurityDescriptor: TJwSecurityDescriptor 
Contains security aspects to be assigned to the new desktop  
aName 
Contains the name of an existing Desktop. A desktop name is case sensitive.  
doInherit 
 
aDesirecAccess 
Contains flags that defines the type of opening. You can use the following flags concatenated by OR-Operator : READ_CONTROL, WRITE_DAC, WRITE_OWNER, STANDARD_RIGHTS_READ, STANDARD_RIGHTS_WRITE, STANDARD_RIGHTS_EXECUTE, STANDARD_RIGHTS_ALL, SPECIFIC_RIGHTS_ALL, ACCESS_SYSTEM_SECURITY, MAXIMUM_ALLOWED, GENERIC_READ, GENERIC_WRITE, GENERIC_EXECUTE, GENERIC_ALL, // Desktop-specific access flags DESKTOP_READOBJECTS, DESKTOP_CREATEWINDOW, DESKTOP_CREATEMENU, DESKTOP_HOOKCONTROL, DESKTOP_JOURNALRECORD DESKTOP_JOURNALPLAYBACK, DESKTOP_ENUMERATE, DESKTOP_WRITEOBJECTS You can look up the meanings in MSDN. You must at least use the flag DESKTOP_CREATEWINDOW.  

CreateDesktop returns a handle to the desktop

CreateDesktop creates a new desktop and adds it to the list (if successfull). 

 

Exceptions 
Description 
CreateDesktop 
raises EJwsclCreateDesktopException with an error description if the desktop could not be created. 
Copyright (c) 2010. All rights reserved.
This help was created by Doc-O-Matic sponsored by toolsfactory software inc.
What do you think about this topic? Send feedback!