Platform SDK: Network Management

SERVER_INFO_102

The SERVER_INFO_102 structure contains information about the specified server, including name, platform, type of server, attributes, and associated software.

typedef struct _SERVER_INFO_102 {
  DWORD     sv102_platform_id;
  LPWSTR    sv102_name;
  DWORD     sv102_version_major;
  DWORD     sv102_version_minor;
  DWORD     sv102_type;
  LPWSTR    sv102_comment;
  DWORD     sv102_users;
  LONG      sv102_disc;
  BOOL      sv102_hidden;
  DWORD     sv102_announce;
  DWORD     sv102_anndelta;
  DWORD     sv102_licenses;
  LPWSTR    sv102_userpath;
} SERVER_INFO_102, *PSERVER_INFO_102, *LPSERVER_INFO_102;

Members

sv102_platform_id
Specifies the information level to use for platform-specific information. This member can be one of the following values, defined in the lmcons.h file: PLATFORM_ID_DOS, PLATFORM_ID_OS2, PLATFORM_ID_NT, PLATFORM_ID_OSF, or PLATFORM_ID_VMS.
sv102_name
Pointer to a Unicode string specifying the name of a server.
sv102_version_major
Specifies, in the least significant 4 bits, the major release version number of the operating system. The most significant 4 bits specifies the server type. The mask MAJOR_VERSION_MASK should be used to ensure correct results.
sv102_version_minor
Specifies the minor release version number of the operating system.
sv102_type
Specifies the type of software the computer is running. This member can be one of the following values.
Value Meaning
SV_TYPE_WORKSTATION A LAN Manager workstation
SV_TYPE_SERVER A LAN Manager server
SV_TYPE_SQLSERVER Any server running with Microsoft SQL Server
SV_TYPE_DOMAIN_CTRL Primary domain controller
SV_TYPE_DOMAIN_BAKCTRL Backup domain controller
SV_TYPE_TIME_SOURCE Server running the Timesource service
SV_TYPE_AFP Apple File Protocol server
SV_TYPE_NOVELL Novell server
SV_TYPE_DOMAIN_MEMBER LAN Manager 2.x domain member
SV_TYPE_LOCAL_LIST_ONLY Servers maintained by the browser
SV_TYPE_PRINTQ_SERVER Server sharing print queue
SV_TYPE_DIALIN_SERVER Server running dial-in service
SV_TYPE_XENIX_SERVER Xenix server
SV_TYPE_SERVER_MFPN Microsoft File and Print for NetWare
SV_TYPE_NT Windows NT/Windows 2000 workstation or server
SV_TYPE_WFW Server running Windows for Workgroups
SV_TYPE_SERVER_NT Windows NT/Windows 2000 server that is not a domain controller
SV_TYPE_POTENTIAL_BROWSER Server that can run the browser service
SV_TYPE_BACKUP_BROWSER Server running a browser service as backup
SV_TYPE_MASTER_BROWSER Server running the master browser service
SV_TYPE_DOMAIN_MASTER Server running the domain master browser
SV_TYPE_DOMAIN_ENUM Primary domain
SV_TYPE_WINDOWS Windows 95 or later
SV_TYPE_ALL All servers
SV_TYPE_TERMINALSERVER Terminal Server
SV_TYPE_CLUSTER_NT Server clusters available in the domain

sv102_comment
Pointer to a Unicode string specifying a comment describing the server. The comment can be null.
sv102_users
Specifies the number of users who can attempt to log on to the system server. Note that it is the license server that determines how many of these users can actually log on.
sv102_disc
Specifies the auto-disconnect time, in minutes. A session is disconnected if it is idle longer than the period of time specified by the sv102_disc member. If the value of sv102_disc is SV_NODISC, auto-disconnect is not enabled.
sv102_hidden
Specifies whether the server is visible to other computers in the same network domain. This member can be one of the following values.
Value Meaning
SV_VISIBLE Server is visible.
SV_HIDDEN Server is not visible.

sv102_announce
Specifies the network announce rate, in seconds. This rate determines how often the server is announced to other computers on the network. For more information about how much the announce rate can vary from the period of time specified by this member, see SERVER_INFO_1018.
sv102_anndelta
Specifies the delta value for the announce rate, in milliseconds. This value specifies how much the announce rate can vary from the period of time specified in the sv102_announce member.

The delta value allows randomly varied announce rates. For example, if the sv102_announce member has the value 10 and the sv102_anndelta member has the value 1, the announce rate can vary from 9.999 seconds to 10.001 seconds.

sv102_licenses
Specifies the number of users per license. By default, this number is SV_USERS_PER_LICENSE.
sv102_userpath
Pointer to a Unicode string specifying the path to user directories.

Remarks

To retrieve a value that indicates whether a share is the root volume in a Dfs tree structure, you must call the NetShareGetInfo function and specify information level 1005.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Unsupported.
  Header: Declared in Lmserver.h.

See Also

Network Management Overview, Network Management Structures, Server Functions, NetServerGetInfo, NetServerSetInfo, NetShareGetInfo, SERVER_INFO_1018