SERVER_INFO_102 結構 (lmserver.h)

發行項
08/24/2023

SERVER_INFO_102結構包含指定伺服器的相關資訊，包括名稱、平臺、伺服器類型、屬性和相關聯的軟體。

語法

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

成員

sv102_platform_id

類型： DWORD

用於平臺特定資訊的資訊層級。

此成員的可能值會列在 Lmcons.h 標頭檔中。

值	意義
PLATFORM_ID_DOS 300	MS-DOS 平臺。
PLATFORM_ID_OS2 400	OS/2 平臺。
PLATFORM_ID_NT 500	Windows NT 平臺。
PLATFORM_ID_OSF 600	OSF 平臺。
PLATFORM_ID_VMS 700	VMS 平臺。

sv102_name

類型： LPWSTR

指定伺服器名稱的 Unicode 字串指標。

sv102_version_major

類型： DWORD

主要版本號碼和伺服器類型。

作業系統的主要版本號碼是在最小有效 4 位中指定。伺服器類型是在最重要的 4 位中指定。應用程式應該使用Lmserver.h標頭中定義的MAJOR_VERSION_MASK位元遮罩，以從這個成員取得主要版本號碼。

sv102_version_minor

類型： DWORD

作業系統的次要版本號碼。

sv102_type

類型： DWORD

電腦執行的軟體類型。

此成員的可能值會列在 Lmserver.h 標頭檔中。這個成員可以是下列其中一些值的組合。

值	意義
SV_TYPE_WORKSTATION 0x00000001	工作站。
SV_TYPE_SERVER 0x00000002	伺服器。
SV_TYPE_SQLSERVER 0x00000004	使用 Microsoft SQL Server 執行的伺服器。
SV_TYPE_DOMAIN_CTRL 0x00000008	主要網域控制站。
SV_TYPE_DOMAIN_BAKCTRL 0x00000010	備份網域控制站。
SV_TYPE_TIME_SOURCE 0x00000020	執行 Timesource 服務的伺服器。
SV_TYPE_AFP 0x00000040	執行 Apple File Protocol (AFP) 檔服務的伺服器。
SV_TYPE_NOVELL 0x00000080	Novell 伺服器。
SV_TYPE_DOMAIN_MEMBER 0x00000100	LAN Manager 2.x 網域成員。
SV_TYPE_PRINTQ_SERVER 0x00000200	共用列印佇列的伺服器。
SV_TYPE_DIALIN_SERVER 0x00000400	執行撥入服務的伺服器。
SV_TYPE_XENIX_SERVER 0x00000800	Xenix 或 Unix 伺服器。
SV_TYPE_NT 0x00001000	工作站或伺服器。
SV_TYPE_WFW 0x00002000	執行 Windows for Workgroups 的電腦。
SV_TYPE_SERVER_MFPN 0x00004000	執行 Microsoft File and Print for NetWare 服務的伺服器。
SV_TYPE_SERVER_NT 0x00008000	任何不是網域控制站的伺服器。
SV_TYPE_POTENTIAL_BROWSER 0x00010000	可執行瀏覽器服務的電腦。
SV_TYPE_BACKUP_BROWSER 0x00020000	執行瀏覽器服務作為備份的伺服器。
SV_TYPE_MASTER_BROWSER 0x00040000	執行主瀏覽器服務的伺服器。
SV_TYPE_DOMAIN_MASTER 0x00080000	執行網域主機瀏覽器的伺服器。
SV_TYPE_SERVER_OSF 0x00100000	執行 OSF 的電腦。
SV_TYPE_SERVER_VMS 0x00200000	執行 VMS 的電腦。
SV_TYPE_WINDOWS 0x00400000	執行 Windows 的電腦。
SV_TYPE_DFS 0x00800000	伺服器，這是 DFS 樹狀結構的根目錄。
SV_TYPE_CLUSTER_NT 0x01000000	網域中可用的伺服器叢集。
SV_TYPE_TERMINALSERVER 0x02000000	執行終端機伺服器服務的伺服器。
SV_TYPE_CLUSTER_VS_NT 0x04000000	網域中可用的叢集虛擬伺服器。 Windows 2000：不支援此值。
SV_TYPE_DCE 0x10000000	執行 DCE 目錄和安全性服務或對等的伺服器。
SV_TYPE_ALTERNATE_XPORT 0x20000000	由替代傳輸傳回的伺服器。
SV_TYPE_LOCAL_LIST_ONLY 0x40000000	瀏覽器所維護的伺服器。
SV_TYPE_DOMAIN_ENUM 0x80000000	主要網域。

SV_TYPE_ALL常數定義為在 Lmserver.h標頭檔中0xFFFFFFFF。當與 NetServerEnum 函式搭配使用時，這個常數可用來檢查所有伺服器類型。

sv102_comment

類型： LPWSTR

Unicode 字串的指標，指定描述伺服器的批註。批註可以是 Null。

sv102_users

類型： DWORD

嘗試登入系統伺服器的使用者數目。請注意，這是決定這些使用者可以實際登入的授權伺服器。

sv102_disc

類型： LONG

自動中斷連線的時間，以分鐘為單位。如果會話閒置時間超過 sv102_disc 成員所指定的時段，會話就會中斷連線。如果 sv102_disc 的值是SV_NODISC，則不會啟用自動中斷連線。

sv102_hidden

類型： BOOL

值，指出伺服器是否對相同網路網域中的其他電腦可見。這個成員可以是 Lmserver.h 標頭檔中定義的下列其中一個值。

值	意義
SV_VISIBLE	伺服器可見。
SV_HIDDEN	伺服器看不到。

sv102_announce

類型： DWORD

網路宣告速率，以秒為單位。此速率會決定伺服器在網路上宣佈給其他電腦的頻率。如需此成員所指定時段的宣告率可能會有所不同的詳細資訊，請參閱 SERVER_INFO_1018。

sv102_anndelta

類型： DWORD

宣告率的差異值，以毫秒為單位。這個值會指定宣告率會隨著 sv102_announce 成員中指定的時間週期而有所不同。

差異值允許隨機變化的宣告率。例如，如果 sv102_announce 成員的值為 10， 而sv102_anndelta 成員的值為 1，則宣告速率可能會從 9.999 秒到 10.001 秒。

sv102_licenses

類型： DWORD

每個授權的使用者數目。根據預設，此數位會SV_USERS_PER_LICENSE。

sv102_userpath

類型： LPWSTR

指定使用者目錄路徑的 Unicode 字串指標。

備註

若要擷取值，指出共用是否為 Dfs 樹狀結構中的根磁片區，您必須呼叫 NetShareGetInfo 函式並指定資訊層級 1005。

需求


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	lmserver.h (包括 Lm.h)