Class WinUser


  • public class WinUser
    extends java.lang.Object
    Collection of static methods to create or delete users and local groups on Windows.

    If a helper process with elevated privileges has been created by the "Request privileges" action, the methods of this class are pushed to the helper process. Please see the help topic on "Elevation Of Privileges" for more information.

    • Constructor Detail

      • WinUser

        public WinUser()
    • Method Detail

      • deleteUser

        public static boolean deleteUser​(java.lang.String nameOrSid)
        Delete a user.
        Parameters:
        nameOrSid - an account name or a SID in String form
        Returns:
        true if successful or if the user doesn't exist
      • deleteLocalGroup

        public static boolean deleteLocalGroup​(java.lang.String nameOrSid)
        Delete a local group.
        Parameters:
        nameOrSid - an account name or a SID in String form
        Returns:
        true if successful or if the local group doesn't exist
      • addUser

        public static WinUser.AddUserResult addUser​(java.lang.String name,
                                                    java.lang.String password,
                                                    java.lang.String comment,
                                                    WinUser.GroupCreationMode groupCreationMode,
                                                    java.lang.String localGroupNameOrSid,
                                                    java.lang.String localGroupComment)
        Add a user and optionally a local group.
        Parameters:
        name - the user name
        password - the password for the account
        comment - an optional comment. Can be null
        groupCreationMode - how the group should be created
        localGroupNameOrSid - a group name or optionally a SID if the group already exists. Can be null for WinUser.GroupCreationMode.NONE.
        localGroupComment - an optional comment for the local group. Can be null
        Returns:
        the result of the operation
      • getAccountName

        public static java.lang.String getAccountName​(java.lang.String sid)
        Try to get an account name for a SID (Security Identifier).
        Parameters:
        sid - the SID in String form
        Returns:
        A qualified account name or null if the account could not be found.
      • getUserName

        public static java.lang.String getUserName​(java.lang.String sid)
        Try to get the user name (an unqualified account name) for a SID (Security Identifier).
        Parameters:
        sid - the SID in String form
        Returns:
        An unqualified account name or null if the account could not be found.
      • getUserSid

        public static java.lang.String getUserSid()
        Get the users SID (Security Identifier) of the current process.
        Returns:
        A SID in String form or null if the method fails.