NetUserModalsSet
The NetUserModalsSet
function sets global information for all users and global groups in the
security database.
Security Requirements
Only members
of the Administrators or Account Operators local group can successfully execute
NetUserModalsSet.
NET_API_STATUS NetUserModalsSet(
|
LPWSTR servername, |
|
|
DWORD level, |
|
|
LPBYTE buf, |
|
|
LPDWORD parm_err |
|
|
); |
|
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.
level
Specifies one
of the following values to set the level of information provided.
|
Value |
Meaning |
|
0 |
The buf
parameter points to a USER_MODALS_INFO_0 structure. |
|
1 |
The buf
parameter points to a USER_MODALS_INFO_1 structure. |
|
2 |
The buf
parameter points to a USER_MODALS_INFO_2 structure. |
|
3 |
The buf
parameter points to a USER_MODALS_INFO_3 structure. |
|
1001 |
The buf
parameter points to a USER_MODALS_INFO_1001EETRMV structure. |
|
1002 |
The buf
parameter points to a USER_MODALS_INFO_1002EFTRMV structure. |
|
1003 |
The buf
parameter points to a USER_MODALS_INFO_1003EGTRMV structure. |
|
1004 |
The buf
parameter points to a USER_MODALS_INFO_1004EHTRMV structure. |
|
1005 |
The buf
parameter points to a USER_MODALS_INFO_1005EITRMV structure. |
|
1006 |
The buf
parameter points to a USER_MODALS_INFO_1006EJTRMV structure. |
|
1007 |
The buf
parameter points to a USER_MODALS_INFO_1007EKTRMV structure. |
buf
Points to the
buffer in which the data set with the level parameter is stored. The
returned buffer should be deallocated using the NetApiBufferFree function.
parm_err
Optional
pointer to a DWORD that contains the index of the first parameter that
causes ERROR_INVALID_PARAMETER. If NULL, the parameter is not returned on
error.
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_UserNotFound |
The user
name could not be found. |
See Also