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

SERVER_INFO_101

構造体
サイズx64: 40 バイト / x86: 24 バイト

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

フィールド

フィールドサイズx64x86説明
sv101_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 プラットフォームです。
sv101_nameLPWSTR8/4+8+4サーバー名を指定する Unicode 文字列へのポインターです。
sv101_version_majorDWORD4+16+8

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

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

sv101_version_minorDWORD4+20+12オペレーティングシステムのマイナーリリースバージョン番号です。
sv101_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 Directory and Security Services またはそれと同等のサービスを実行しているサーバーです。
SV_TYPE_ALTERNATE_XPORT
0x20000000
代替トランスポートによって返されるサーバーです。
SV_TYPE_LOCAL_LIST_ONLY
0x40000000
ブラウザーによって管理されているサーバーです。
SV_TYPE_DOMAIN_ENUM
0x80000000
プライマリドメインです。

SV_TYPE_ALL 定数は、Lmserver.h ヘッダーファイルで 0xFFFFFFFF として定義されています。この定数を NetServerEnum 関数と組み合わせて使用すると、すべてのサーバーの種類を対象にチェックできます。

sv101_commentLPWSTR8/4+32+20サーバーを説明するコメントを指定する Unicode 文字列へのポインターです。コメントは null でもかまいません。

公式ドキュメント

SERVER_INFO_101 構造体には、名前、プラットフォーム、サーバーの種類、関連するソフトウェアなど、指定したサーバーに関する情報が格納されます。

解説(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_101  (x64 40 / x86 24 バイト)
typedef struct SERVER_INFO_101 {
    DWORD sv101_platform_id;
    LPWSTR sv101_name;
    DWORD sv101_version_major;
    DWORD sv101_version_minor;
    NET_SERVER_TYPE sv101_type;
    LPWSTR sv101_comment;
} SERVER_INFO_101;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SERVER_INFO_101
{
    public uint sv101_platform_id;
    public IntPtr sv101_name;
    public uint sv101_version_major;
    public uint sv101_version_minor;
    public uint sv101_type;
    public IntPtr sv101_comment;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SERVER_INFO_101
    Public sv101_platform_id As UInteger
    Public sv101_name As IntPtr
    Public sv101_version_major As UInteger
    Public sv101_version_minor As UInteger
    Public sv101_type As UInteger
    Public sv101_comment As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class SERVER_INFO_101(ctypes.Structure):
    _fields_ = [
        ("sv101_platform_id", wintypes.DWORD),
        ("sv101_name", ctypes.c_void_p),
        ("sv101_version_major", wintypes.DWORD),
        ("sv101_version_minor", wintypes.DWORD),
        ("sv101_type", wintypes.DWORD),
        ("sv101_comment", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct SERVER_INFO_101 {
    pub sv101_platform_id: u32,
    pub sv101_name: *mut core::ffi::c_void,
    pub sv101_version_major: u32,
    pub sv101_version_minor: u32,
    pub sv101_type: u32,
    pub sv101_comment: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type SERVER_INFO_101 struct {
	sv101_platform_id uint32
	sv101_name uintptr
	sv101_version_major uint32
	sv101_version_minor uint32
	sv101_type uint32
	sv101_comment uintptr
}
type
  SERVER_INFO_101 = record
    sv101_platform_id: DWORD;
    sv101_name: Pointer;
    sv101_version_major: DWORD;
    sv101_version_minor: DWORD;
    sv101_type: DWORD;
    sv101_comment: Pointer;
  end;
const SERVER_INFO_101 = extern struct {
    sv101_platform_id: u32,
    sv101_name: ?*anyopaque,
    sv101_version_major: u32,
    sv101_version_minor: u32,
    sv101_type: u32,
    sv101_comment: ?*anyopaque,
};
type
  SERVER_INFO_101 {.bycopy.} = object
    sv101_platform_id: uint32
    sv101_name: pointer
    sv101_version_major: uint32
    sv101_version_minor: uint32
    sv101_type: uint32
    sv101_comment: pointer
struct SERVER_INFO_101
{
    uint sv101_platform_id;
    void* sv101_name;
    uint sv101_version_major;
    uint sv101_version_minor;
    uint sv101_type;
    void* sv101_comment;
}

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_101 サイズ: 24 バイト(x86)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; sv101_platform_id : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; sv101_name : LPWSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; sv101_version_major : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; sv101_version_minor : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; sv101_type : NET_SERVER_TYPE (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; sv101_comment : LPWSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SERVER_INFO_101 サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; sv101_platform_id : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; sv101_name : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; sv101_version_major : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; sv101_version_minor : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; sv101_type : NET_SERVER_TYPE (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; sv101_comment : LPWSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SERVER_INFO_101
    #field int sv101_platform_id
    #field intptr sv101_name
    #field int sv101_version_major
    #field int sv101_version_minor
    #field int sv101_type
    #field intptr sv101_comment
#endstruct

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