Workstation and Workstation User Functions

Platform SDK: Network Management

Workstation and Workstation User Functions

The network management workstation functions perform administrative tasks on a local or remote workstation. Any user or application with admin group membership, on a local or remote server, can perform administrative tasks on a workstation to control its operation, user access, and resource sharing.

The workstation functions are listed following.

Function	Description
NetWkstaGetInfo	Returns information about the configuration elements for a workstation.
NetWkstaSetInfo	Configures a workstation.

The workstation functions allow access to two discrete types of workstation information:

System information
Platform-specific information (Windows NT, OS/2, MS-DOS, and so on)

Within each type the data is categorized by security access. Data that is guest-accessible is a subset of the data that is user-accessible, which is in turn a subset of the admin-accessible data.

The workstation information structures have been restructured from those of LAN Manager 2.x to allow the information to be grouped by type and security accesses. The LAN Manager 2.x workstation information format has been discontinued due to the following:

The base levels (0 and 1) were not grouped by accessibility. A non-superset level (level 10) was required to allow guest access to the information.
Platform-specific implementation information was included in the base levels such that every platform had to return all information including a default for non-relevant fields. This increased the size of the information structures unnecessarily, making the functions cumbersome to use.

Workstation information is available at the following levels:

WKSTA_INFO_100
WKSTA_INFO_101
WKSTA_INFO_102

The network management workstation user functions allow access to user-specific information. The user-specific information is separated from the workstation information because there can be more than one user on a workstation.

The workstation user functions are listed following.

Function	Description
NetWkstaUserEnum	Lists information about all users currently logged on to the workstation.
NetWkstaUserGetInfo	Returns information about one currently logged-on user.
NetWkstaUserSetInfo	Sets the user-specific information for the configuration elements of a workstation.

Workstation user information is available at the following levels:

WKSTA_USER_INFO_0
WKSTA_USER_INFO_1
WKSTA_USER_INFO_1101