Win32 API 日本語リファレンス
ホームNetworking.WinSock › SERVICE_INFOA

SERVICE_INFOA

構造体
サイズx64: 80 バイト / x86: 44 バイト

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

フィールド

フィールドサイズx64x86説明
lpServiceTypeGUID*8/4+0+0ネットワークサービスの種類を表す GUID へのポインターです。
lpServiceNameLPSTR8/4+8+4

ネットワークサービスの名前を表す NULL 終端文字列へのポインターです。

dwNameSpace パラメーターに NS_DEFAULT を指定して SetService 関数を呼び出す場合、ネットワークサービス名は共通名でなければなりません。共通名とは、そのネットワークサービスが一般的に知られている名前です。ネットワークサービスの共通名の例としては "My SQL Server" があります。

dwNameSpace パラメーターに特定のサービス名を指定して SetService 関数を呼び出す場合、ネットワークサービス名には共通名または識別名を使用できます。識別名は、ディレクトリサービス内の一意の場所によってサービスを識別します。ネットワークサービスの識別名の例としては "MS\SYS\NT\DEV\My SQL Server" があります。

lpCommentLPSTR8/4+16+8ネットワークサービスのコメントまたは説明を表す NULL 終端文字列へのポインターです。例: "Used for development upgrades."
lpLocaleLPSTR8/4+24+12ロケール情報を格納する NULL 終端文字列へのポインターです。
dwDisplayHintRESOURCE_DISPLAY_TYPE4+32+16

ネットワーク参照用のユーザーインターフェイスでネットワークサービスをどのように表示するかを示すヒントです。次の値のいずれかを指定できます。

意味
RESOURCEDISPLAYTYPE_DOMAIN
ネットワークサービスをドメインとして表示します。
RESOURCEDISPLAYTYPE_FILE
ネットワークサービスをファイルとして表示します。
RESOURCEDISPLAYTYPE_GENERIC
オブジェクトの表示方法は問いません。
RESOURCEDISPLAYTYPE_GROUP
ネットワークサービスをグループとして表示します。
RESOURCEDISPLAYTYPE_SERVER
ネットワークサービスをサーバーとして表示します。
RESOURCEDISPLAYTYPE_SHARE
ネットワークサービスを共有ポイントとして表示します。
RESOURCEDISPLAYTYPE_TREE
ネットワークサービスをツリーとして表示します。
dwVersionDWORD4+36+20ネットワークサービスのバージョンです。この値の上位ワードはメジャーバージョン番号を、下位ワードはマイナーバージョン番号を指定します。
dwTimeDWORD4+40+24将来の使用のために予約済みです。0 でなければなりません。
lpMachineNameLPSTR8/4+48+28ネットワークサービスが実行されているコンピューターの名前を表す NULL 終端文字列へのポインターです。
lpServiceAddressSERVICE_ADDRESSES*8/4+56+32

SERVICE_ADDRESS 構造体の配列を格納する SERVICE_ADDRESSES 構造体へのポインターです。各 SERVICE_ADDRESS 構造体には、ネットワークサービスのアドレスに関する情報が格納されます。

ネットワークサービスは getsockname 関数を呼び出して、システムのローカルアドレスを取得できます。

ServiceSpecificInfoBLOB16/8+64+36

サービス固有の情報を指定する BLOB 構造体です。

注意 一般に、 BLOB 構造体の pBlobData メンバーが指すデータには、ポインターを含めてはなりません。これは、データの形式を把握しているのはネットワークサービスだけであり、その情報なしにデータをコピーするとポインターが無効になるためです。pBlobData が指すデータに可変長の要素が含まれる場合は、pBlobData からのオフセットを使用してそれらの要素の位置を示すことができます。この一般的な規則には 1 つだけ例外があります。pBlobDataSERVICE_TYPE_INFO_ABS 構造体を指す場合です。これは、 SERVICE_TYPE_INFO_ABS 構造体と、そこに含まれる SERVICE_TYPE_VALUE_ABS 構造体がいずれも定義済みであり、その形式がオペレーティングシステムに知られているために可能となっています。

公式ドキュメント

SERVICE_INFO 構造体は、ネットワークサービスまたはネットワークサービスの種類に関する情報を格納します。

解説(Remarks)

メモ

nspapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に応じて、この関数の ANSI 版と Unicode 版を自動的に選択するエイリアスとして SERVICE_INFO を定義しています。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させると、不一致が生じてコンパイルエラーや実行時エラーの原因となる場合があります。詳細については、関数プロトタイプの規則 を参照してください。

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

各言語での定義

#include <windows.h>

// BLOB  (x64 16 / x86 8 バイト)
typedef struct BLOB {
    DWORD cbSize;
    BYTE* pBlobData;
} BLOB;

// SERVICE_INFOA  (x64 80 / x86 44 バイト)
typedef struct SERVICE_INFOA {
    GUID* lpServiceType;
    LPSTR lpServiceName;
    LPSTR lpComment;
    LPSTR lpLocale;
    RESOURCE_DISPLAY_TYPE dwDisplayHint;
    DWORD dwVersion;
    DWORD dwTime;
    LPSTR lpMachineName;
    SERVICE_ADDRESSES* lpServiceAddress;
    BLOB ServiceSpecificInfo;
} SERVICE_INFOA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct BLOB
{
    public uint cbSize;
    public IntPtr pBlobData;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SERVICE_INFOA
{
    public IntPtr lpServiceType;
    public IntPtr lpServiceName;
    public IntPtr lpComment;
    public IntPtr lpLocale;
    public uint dwDisplayHint;
    public uint dwVersion;
    public uint dwTime;
    public IntPtr lpMachineName;
    public IntPtr lpServiceAddress;
    public BLOB ServiceSpecificInfo;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure BLOB
    Public cbSize As UInteger
    Public pBlobData As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SERVICE_INFOA
    Public lpServiceType As IntPtr
    Public lpServiceName As IntPtr
    Public lpComment As IntPtr
    Public lpLocale As IntPtr
    Public dwDisplayHint As UInteger
    Public dwVersion As UInteger
    Public dwTime As UInteger
    Public lpMachineName As IntPtr
    Public lpServiceAddress As IntPtr
    Public ServiceSpecificInfo As BLOB
End Structure
import ctypes
from ctypes import wintypes

class BLOB(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("pBlobData", ctypes.c_void_p),
    ]

class SERVICE_INFOA(ctypes.Structure):
    _fields_ = [
        ("lpServiceType", ctypes.c_void_p),
        ("lpServiceName", ctypes.c_void_p),
        ("lpComment", ctypes.c_void_p),
        ("lpLocale", ctypes.c_void_p),
        ("dwDisplayHint", wintypes.DWORD),
        ("dwVersion", wintypes.DWORD),
        ("dwTime", wintypes.DWORD),
        ("lpMachineName", ctypes.c_void_p),
        ("lpServiceAddress", ctypes.c_void_p),
        ("ServiceSpecificInfo", BLOB),
    ]
#[repr(C)]
pub struct BLOB {
    pub cbSize: u32,
    pub pBlobData: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct SERVICE_INFOA {
    pub lpServiceType: *mut core::ffi::c_void,
    pub lpServiceName: *mut core::ffi::c_void,
    pub lpComment: *mut core::ffi::c_void,
    pub lpLocale: *mut core::ffi::c_void,
    pub dwDisplayHint: u32,
    pub dwVersion: u32,
    pub dwTime: u32,
    pub lpMachineName: *mut core::ffi::c_void,
    pub lpServiceAddress: *mut core::ffi::c_void,
    pub ServiceSpecificInfo: BLOB,
}
import "golang.org/x/sys/windows"

type BLOB struct {
	cbSize uint32
	pBlobData uintptr
}

type SERVICE_INFOA struct {
	lpServiceType uintptr
	lpServiceName uintptr
	lpComment uintptr
	lpLocale uintptr
	dwDisplayHint uint32
	dwVersion uint32
	dwTime uint32
	lpMachineName uintptr
	lpServiceAddress uintptr
	ServiceSpecificInfo BLOB
}
type
  BLOB = record
    cbSize: DWORD;
    pBlobData: Pointer;
  end;

  SERVICE_INFOA = record
    lpServiceType: Pointer;
    lpServiceName: Pointer;
    lpComment: Pointer;
    lpLocale: Pointer;
    dwDisplayHint: DWORD;
    dwVersion: DWORD;
    dwTime: DWORD;
    lpMachineName: Pointer;
    lpServiceAddress: Pointer;
    ServiceSpecificInfo: BLOB;
  end;
const BLOB = extern struct {
    cbSize: u32,
    pBlobData: ?*anyopaque,
};

const SERVICE_INFOA = extern struct {
    lpServiceType: ?*anyopaque,
    lpServiceName: ?*anyopaque,
    lpComment: ?*anyopaque,
    lpLocale: ?*anyopaque,
    dwDisplayHint: u32,
    dwVersion: u32,
    dwTime: u32,
    lpMachineName: ?*anyopaque,
    lpServiceAddress: ?*anyopaque,
    ServiceSpecificInfo: BLOB,
};
type
  BLOB {.bycopy.} = object
    cbSize: uint32
    pBlobData: pointer

  SERVICE_INFOA {.bycopy.} = object
    lpServiceType: pointer
    lpServiceName: pointer
    lpComment: pointer
    lpLocale: pointer
    dwDisplayHint: uint32
    dwVersion: uint32
    dwTime: uint32
    lpMachineName: pointer
    lpServiceAddress: pointer
    ServiceSpecificInfo: BLOB
struct BLOB
{
    uint cbSize;
    void* pBlobData;
}

struct SERVICE_INFOA
{
    void* lpServiceType;
    void* lpServiceName;
    void* lpComment;
    void* lpLocale;
    uint dwDisplayHint;
    uint dwVersion;
    uint dwTime;
    void* lpMachineName;
    void* lpServiceAddress;
    BLOB ServiceSpecificInfo;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SERVICE_INFOA サイズ: 44 バイト(x86)
dim st, 11    ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; lpServiceType : GUID* (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; lpServiceName : LPSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; lpComment : LPSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; lpLocale : LPSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwDisplayHint : RESOURCE_DISPLAY_TYPE (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwVersion : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwTime : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; lpMachineName : LPSTR (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; lpServiceAddress : SERVICE_ADDRESSES* (+32, 4byte)  varptr(st)+32 を基点に操作(4byte:入れ子/配列)
; ServiceSpecificInfo : BLOB (+36, 8byte)  varptr(st)+36 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SERVICE_INFOA サイズ: 80 バイト(x64)
dim st, 20    ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; lpServiceType : GUID* (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; lpServiceName : LPSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; lpComment : LPSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; lpLocale : LPSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; dwDisplayHint : RESOURCE_DISPLAY_TYPE (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwVersion : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; dwTime : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; lpMachineName : LPSTR (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; lpServiceAddress : SERVICE_ADDRESSES* (+56, 8byte)  varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; ServiceSpecificInfo : BLOB (+64, 16byte)  varptr(st)+64 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global BLOB
    #field int cbSize
    #field intptr pBlobData
#endstruct

#defstruct global SERVICE_INFOA
    #field intptr lpServiceType
    #field intptr lpServiceName
    #field intptr lpComment
    #field intptr lpLocale
    #field int dwDisplayHint
    #field int dwVersion
    #field int dwTime
    #field intptr lpMachineName
    #field intptr lpServiceAddress
    #field BLOB ServiceSpecificInfo
#endstruct

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