UlteriusServer.Api.Win32.Desktop.Create C# (CSharp) Method

Create() public method

Creates a new desktop. If a handle is open, it will be closed.
public Create ( string name ) : bool
name string The name of the new desktop. Must be unique, and is case sensitive.
return bool
        public bool Create(string name)
        {
            // make sure object isnt disposed.
            CheckDisposed();

            // close the open desktop.
            if (DesktopHandle != IntPtr.Zero)
            {
                // attempt to close the desktop.
                if (!Close()) return false;
            }

            // make sure desktop doesnt already exist.
            if (Exists(name))
            {
                // it exists, so open it.
                return Open(name);
            }

            // attempt to create desktop.
            DesktopHandle = CreateDesktop(name, IntPtr.Zero, IntPtr.Zero, 0, AccessRights, IntPtr.Zero);

            DesktopName = name;

            // something went wrong.
            if (DesktopHandle == IntPtr.Zero) return false;

            return true;
        }

Usage Example

Example #1
0
        /// <summary>
        ///     Creates a new desktop.
        /// </summary>
        /// <param name="name">The name of the desktop to create.  Names are case sensitive.</param>
        /// <returns>If successful, a Desktop object, otherwise, null.</returns>
        public static Desktop CreateDesktop(string name)
        {
            // open the desktop.
            var desktop = new Desktop();
            var result  = desktop.Create(name);

            // somethng went wrong.
            if (!result)
            {
                return(null);
            }

            return(desktop);
        }
All Usage Examples Of UlteriusServer.Api.Win32.Desktop::Create