Win32 API 日本語リファレンス
ホームNetworkManagement.NetManagement › SERVER_INFO_102

SERVER_INFO_102

構造体
サイズx64: 72 バイト / x86: 52 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
sv102_platform_idDWORD4+0+0

プラットフォーム固有の情報に使用する情報レベルです。

このメンバーに指定できる値は、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_nameLPWSTR8/4+8+4サーバーの名前を指定する Unicode 文字列へのポインターです。
sv102_version_majorDWORD4+16+8

メジャーバージョン番号とサーバーの種類です。

オペレーティングシステムのメジャーリリースバージョン番号は最下位 4 ビットに格納されます。サーバーの種類は最上位 4 ビットに格納されます。アプリケーションは、このメンバーからメジャーバージョン番号を取得するために、Lmserver.h ヘッダーで定義されている MAJOR_VERSION_MASK ビットマスクを使用してください。

sv102_version_minorDWORD4+20+12オペレーティングシステムのマイナーリリースバージョン番号です。
sv102_typeNET_SERVER_TYPE4+24+16

コンピューターが実行しているソフトウェアの種類です。

このメンバーに指定できる値は、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 Filing 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_commentLPWSTR8/4+32+20サーバーを説明するコメントを指定する Unicode 文字列へのポインターです。このコメントは null でもかまいません。
sv102_usersDWORD4+40+24このシステムサーバーへのログオンを試行できるユーザーの数です。実際にログオンできるユーザー数を決定するのはライセンスサーバーであることに注意してください。
sv102_discINT4+44+28自動切断までの時間(分単位)です。sv102_disc メンバーで指定された時間を超えてアイドル状態が続いたセッションは切断されます。sv102_disc の値が SV_NODISC の場合、自動切断は有効になりません。
sv102_hiddenSERVER_INFO_HIDDEN4+48+32

同じネットワークドメイン内の他のコンピューターからサーバーが見えるかどうかを示す値です。このメンバーには、Lmserver.h ヘッダーファイルで定義されている次のいずれかの値を指定できます。

意味
SV_VISIBLE
サーバーは表示されます。
SV_HIDDEN
サーバーは表示されません。
sv102_announceDWORD4+52+36ネットワークへのアナウンス間隔(秒単位)です。この間隔によって、サーバーがネットワーク上の他のコンピューターにアナウンスされる頻度が決まります。このメンバーで指定された時間からアナウンス間隔がどの程度変動しうるかについて詳しくは、 SERVER_INFO_1018 を参照してください。
sv102_anndeltaDWORD4+56+40

アナウンス間隔のデルタ値(ミリ秒単位)です。この値は、sv102_announce メンバーで指定された時間からアナウンス間隔がどの程度変動しうるかを指定します。

デルタ値により、アナウンス間隔をランダムに変動させることができます。たとえば、sv102_announce メンバーの値が 10 で sv102_anndelta メンバーの値が 1 の場合、アナウンス間隔は 9.999 秒から 10.001 秒の範囲で変動します。

sv102_licensesDWORD4+60+44ライセンスあたりのユーザー数です。既定では、この数は SV_USERS_PER_LICENSE です。
sv102_userpathLPWSTR8/4+64+48ユーザーディレクトリへのパスを指定する Unicode 文字列へのポインターです。

公式ドキュメント

            <b>SERVER_INFO_102</b> 構造体は、指定されたサーバーに関する情報(名前、プラットフォーム、サーバーの種類、属性、関連するソフトウェア)を格納します。

解説(Remarks)

共有が Dfs ツリー構造内のルートボリュームかどうかを示す値を取得するには、 NetShareGetInfo 関数を呼び出し、情報レベル 1005 を指定する必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// SERVER_INFO_102  (x64 72 / x86 52 バイト)
typedef struct SERVER_INFO_102 {
    DWORD sv102_platform_id;
    LPWSTR sv102_name;
    DWORD sv102_version_major;
    DWORD sv102_version_minor;
    NET_SERVER_TYPE sv102_type;
    LPWSTR sv102_comment;
    DWORD sv102_users;
    INT sv102_disc;
    SERVER_INFO_HIDDEN sv102_hidden;
    DWORD sv102_announce;
    DWORD sv102_anndelta;
    DWORD sv102_licenses;
    LPWSTR sv102_userpath;
} SERVER_INFO_102;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SERVER_INFO_102
{
    public uint sv102_platform_id;
    public IntPtr sv102_name;
    public uint sv102_version_major;
    public uint sv102_version_minor;
    public uint sv102_type;
    public IntPtr sv102_comment;
    public uint sv102_users;
    public int sv102_disc;
    public int sv102_hidden;
    public uint sv102_announce;
    public uint sv102_anndelta;
    public uint sv102_licenses;
    public IntPtr sv102_userpath;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SERVER_INFO_102
    Public sv102_platform_id As UInteger
    Public sv102_name As IntPtr
    Public sv102_version_major As UInteger
    Public sv102_version_minor As UInteger
    Public sv102_type As UInteger
    Public sv102_comment As IntPtr
    Public sv102_users As UInteger
    Public sv102_disc As Integer
    Public sv102_hidden As Integer
    Public sv102_announce As UInteger
    Public sv102_anndelta As UInteger
    Public sv102_licenses As UInteger
    Public sv102_userpath As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class SERVER_INFO_102(ctypes.Structure):
    _fields_ = [
        ("sv102_platform_id", wintypes.DWORD),
        ("sv102_name", ctypes.c_void_p),
        ("sv102_version_major", wintypes.DWORD),
        ("sv102_version_minor", wintypes.DWORD),
        ("sv102_type", wintypes.DWORD),
        ("sv102_comment", ctypes.c_void_p),
        ("sv102_users", wintypes.DWORD),
        ("sv102_disc", ctypes.c_int),
        ("sv102_hidden", ctypes.c_int),
        ("sv102_announce", wintypes.DWORD),
        ("sv102_anndelta", wintypes.DWORD),
        ("sv102_licenses", wintypes.DWORD),
        ("sv102_userpath", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct SERVER_INFO_102 {
    pub sv102_platform_id: u32,
    pub sv102_name: *mut core::ffi::c_void,
    pub sv102_version_major: u32,
    pub sv102_version_minor: u32,
    pub sv102_type: u32,
    pub sv102_comment: *mut core::ffi::c_void,
    pub sv102_users: u32,
    pub sv102_disc: i32,
    pub sv102_hidden: i32,
    pub sv102_announce: u32,
    pub sv102_anndelta: u32,
    pub sv102_licenses: u32,
    pub sv102_userpath: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type SERVER_INFO_102 struct {
	sv102_platform_id uint32
	sv102_name uintptr
	sv102_version_major uint32
	sv102_version_minor uint32
	sv102_type uint32
	sv102_comment uintptr
	sv102_users uint32
	sv102_disc int32
	sv102_hidden int32
	sv102_announce uint32
	sv102_anndelta uint32
	sv102_licenses uint32
	sv102_userpath uintptr
}
type
  SERVER_INFO_102 = record
    sv102_platform_id: DWORD;
    sv102_name: Pointer;
    sv102_version_major: DWORD;
    sv102_version_minor: DWORD;
    sv102_type: DWORD;
    sv102_comment: Pointer;
    sv102_users: DWORD;
    sv102_disc: Integer;
    sv102_hidden: Integer;
    sv102_announce: DWORD;
    sv102_anndelta: DWORD;
    sv102_licenses: DWORD;
    sv102_userpath: Pointer;
  end;
const SERVER_INFO_102 = extern struct {
    sv102_platform_id: u32,
    sv102_name: ?*anyopaque,
    sv102_version_major: u32,
    sv102_version_minor: u32,
    sv102_type: u32,
    sv102_comment: ?*anyopaque,
    sv102_users: u32,
    sv102_disc: i32,
    sv102_hidden: i32,
    sv102_announce: u32,
    sv102_anndelta: u32,
    sv102_licenses: u32,
    sv102_userpath: ?*anyopaque,
};
type
  SERVER_INFO_102 {.bycopy.} = object
    sv102_platform_id: uint32
    sv102_name: pointer
    sv102_version_major: uint32
    sv102_version_minor: uint32
    sv102_type: uint32
    sv102_comment: pointer
    sv102_users: uint32
    sv102_disc: int32
    sv102_hidden: int32
    sv102_announce: uint32
    sv102_anndelta: uint32
    sv102_licenses: uint32
    sv102_userpath: pointer
struct SERVER_INFO_102
{
    uint sv102_platform_id;
    void* sv102_name;
    uint sv102_version_major;
    uint sv102_version_minor;
    uint sv102_type;
    void* sv102_comment;
    uint sv102_users;
    int sv102_disc;
    int sv102_hidden;
    uint sv102_announce;
    uint sv102_anndelta;
    uint sv102_licenses;
    void* sv102_userpath;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SERVER_INFO_102 サイズ: 52 バイト(x86)
dim st, 13    ; 4byte整数×13(構造体サイズ 52 / 4 切り上げ)
; sv102_platform_id : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; sv102_name : LPWSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; sv102_version_major : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; sv102_version_minor : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; sv102_type : NET_SERVER_TYPE (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; sv102_comment : LPWSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; sv102_users : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; sv102_disc : INT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; sv102_hidden : SERVER_INFO_HIDDEN (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; sv102_announce : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; sv102_anndelta : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; sv102_licenses : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; sv102_userpath : LPWSTR (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SERVER_INFO_102 サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; sv102_platform_id : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; sv102_name : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; sv102_version_major : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; sv102_version_minor : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; sv102_type : NET_SERVER_TYPE (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; sv102_comment : LPWSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; sv102_users : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; sv102_disc : INT (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; sv102_hidden : SERVER_INFO_HIDDEN (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; sv102_announce : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; sv102_anndelta : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; sv102_licenses : DWORD (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; sv102_userpath : LPWSTR (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SERVER_INFO_102
    #field int sv102_platform_id
    #field intptr sv102_name
    #field int sv102_version_major
    #field int sv102_version_minor
    #field int sv102_type
    #field intptr sv102_comment
    #field int sv102_users
    #field int sv102_disc
    #field int sv102_hidden
    #field int sv102_announce
    #field int sv102_anndelta
    #field int sv102_licenses
    #field intptr sv102_userpath
#endstruct

stdim st, SERVER_INFO_102        ; NSTRUCT 変数を確保
st->sv102_platform_id = 100
mes "sv102_platform_id=" + st->sv102_platform_id