Workstation and Workstation User Functions

The 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 that workstation to control its operation, user access, and resource sharing. The workstation functions are:

NetWkstaGetInfo
NetWkstaSetInfo

The 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:

NetWkstaUserEnum
NetWkstaUserGetInfo
NetWkstaUserSetInfo

The low-level parameters that affect a workstation's operation can be examined and modified by calling NetWkstaGetInfo and NetWkstaSetInfo.

The workstation API structures are restructured from those of LAN Man 2.x to allow the information to be grouped by type and security accesses. The LAN Manager 2.x workstation information format is discontinued due to the following problems:

• The base level (0 and 1) were not grouped by accessibility such that 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 grew the size of the information structures unneccessarily, making the function cumbersome to use.

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

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

Within each group the fields are categorized by security access such that the guest accessible fields are a subset of the user accessible fields that are a subset of the admin accessible fields.

The system information structure contains a platform base number that identifies the levels and format of the platform-specific information structures.

The workstation function information structures are as follows:

WKSTA_INFO_100
WKSTA_INFO_101
WKSTA_INFO_102
WKSTA_INFO_302
WKSTA_INFO_402

The workstation user function information structures are:

WKSTA_USER_INFO_0
WKSTA_USER_INFO_1
WKSTA_USER_INFO_1101

For NetWkstaSetInfo, parmnum values refer to the members of the workstation data information structure, as follows. These values are used when indicating an error in a specific parameter through parm_err.