NetWkstaUserSetInfo

The NetWkstaUserSetInfo function sets the user-specific information about the configuration elements for a workstation.

Security Requirements

This function only works locally.

NET_API_STATUS NetWkstaUserSetInfo(
  LPWSTR reserved,  
  DWORD level,      
  LPBYTE buf,       
  LPDWORD parm_err  
);

Parameters

reserved
This parameter must be set to zero.
level
Specifies one of the following values to set the level of information provided.
Value Meaning
0 The buf parameter points to a WKSTA_USER_INFO_0 structure.
1 The buf parameter points to a WKSTA_USER_INFO_1 structure.
1101 The buf parameter points to a WKSTA_USER_INFO_1101 structure.

buf
On return a pointer to the return information structure is returned in the address pointed to by buf.
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_INVALID_LEVEL The level parameter, which indicates what level of data structure information is available, is invalid.
ERROR_INVALID_PARAMETER One of the function parameters is invalid.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in lmwksta.h.
  Import Library: Use netapi32.lib.

See Also

Networking (Net) Overview, Net Functions, NetWkstaUserGetInfo