NetUserSetGroups
The NetUserSetGroups
function sets global group memberships for a specified user account.
Security Requirements
Only members
of the Administrators or Account Operators local group can successfully execute
NetUserSetGroups.
NET_API_STATUS NetUserSetGroups(
|
LPWSTR servername, |
|
|
LPWSTR username, |
|
|
DWORD level, |
|
|
LPBYTE buf, |
|
|
DWORD num_entries |
|
|
); |
|
Parameters
servername
Pointer to a
Unicode string containing the name of the remote server on which the function
is to execute. A NULL pointer or string specifies the local computer.
username
Pointer to a
Unicode string containing the name of the user for which to set global group
memberships.
level
Specifies one
of the following values to set the level of information provided.
|
Value |
Meaning |
|
0 |
The buf
parameter points to an array of GROUP_USERS_INFO_0 structures. |
|
1 |
The buf
parameter points to an array of GROUP_USERS_INFO_1 structures. |
buf
Pointer to
the buffer in which the data set with the level parameter is stored. The
returned buffer should be deallocated using the NetApiBufferFree function.
num_entries
Number of
global group information structures contained in the array pointed to by buf.
Return Values
If the
function is successful, it returns NERR_SUCCESS.
If the
function fails, the return value is one of the following error codes.
|
Value |
Meaning |
|
ERROR_ACCESS_DENIED |
The user
does not have access to the requested information. |
|
NERR_InvalidComputer |
The
computer name is invalid. |
|
NERR_NotPrimary |
The
operation is allowed only on the primary domain controller of the domain. |
|
NERR_GroupNotFound
|
The local
group specified by the groupname parameter does not exist. |
|
NERR_UserNotFound |
The user
name could not be found. |
See Also