SERVICE_INFOA
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| lpServiceType | GUID* | 8/4 | +0 | +0 | ネットワークサービスの種類を表す GUID へのポインターです。 | ||||||||||||||||
| lpServiceName | LPSTR | 8/4 | +8 | +4 | ネットワークサービスの名前を表す NULL 終端文字列へのポインターです。 dwNameSpace パラメーターに NS_DEFAULT を指定して SetService 関数を呼び出す場合、ネットワークサービス名は共通名でなければなりません。共通名とは、そのネットワークサービスが一般的に知られている名前です。ネットワークサービスの共通名の例としては "My SQL Server" があります。 dwNameSpace パラメーターに特定のサービス名を指定して SetService 関数を呼び出す場合、ネットワークサービス名には共通名または識別名を使用できます。識別名は、ディレクトリサービス内の一意の場所によってサービスを識別します。ネットワークサービスの識別名の例としては "MS\SYS\NT\DEV\My SQL Server" があります。 | ||||||||||||||||
| lpComment | LPSTR | 8/4 | +16 | +8 | ネットワークサービスのコメントまたは説明を表す NULL 終端文字列へのポインターです。例: "Used for development upgrades." | ||||||||||||||||
| lpLocale | LPSTR | 8/4 | +24 | +12 | ロケール情報を格納する NULL 終端文字列へのポインターです。 | ||||||||||||||||
| dwDisplayHint | RESOURCE_DISPLAY_TYPE | 4 | +32 | +16 | ネットワーク参照用のユーザーインターフェイスでネットワークサービスをどのように表示するかを示すヒントです。次の値のいずれかを指定できます。
| ||||||||||||||||
| dwVersion | DWORD | 4 | +36 | +20 | ネットワークサービスのバージョンです。この値の上位ワードはメジャーバージョン番号を、下位ワードはマイナーバージョン番号を指定します。 | ||||||||||||||||
| dwTime | DWORD | 4 | +40 | +24 | 将来の使用のために予約済みです。0 でなければなりません。 | ||||||||||||||||
| lpMachineName | LPSTR | 8/4 | +48 | +28 | ネットワークサービスが実行されているコンピューターの名前を表す NULL 終端文字列へのポインターです。 | ||||||||||||||||
| lpServiceAddress | SERVICE_ADDRESSES* | 8/4 | +56 | +32 | SERVICE_ADDRESS 構造体の配列を格納する SERVICE_ADDRESSES 構造体へのポインターです。各 SERVICE_ADDRESS 構造体には、ネットワークサービスのアドレスに関する情報が格納されます。 ネットワークサービスは getsockname 関数を呼び出して、システムのローカルアドレスを取得できます。 | ||||||||||||||||
| ServiceSpecificInfo | BLOB | 16/8 | +64 | +36 | サービス固有の情報を指定する BLOB 構造体です。 注意 一般に、
BLOB 構造体の pBlobData メンバーが指すデータには、ポインターを含めてはなりません。これは、データの形式を把握しているのはネットワークサービスだけであり、その情報なしにデータをコピーするとポインターが無効になるためです。pBlobData が指すデータに可変長の要素が含まれる場合は、pBlobData からのオフセットを使用してそれらの要素の位置を示すことができます。この一般的な規則には 1 つだけ例外があります。pBlobData が
SERVICE_TYPE_INFO_ABS 構造体を指す場合です。これは、
SERVICE_TYPE_INFO_ABS 構造体と、そこに含まれる
SERVICE_TYPE_VALUE_ABS 構造体がいずれも定義済みであり、その形式がオペレーティングシステムに知られているために可能となっています。
|
公式ドキュメント
SERVICE_INFO 構造体は、ネットワークサービスまたはネットワークサービスの種類に関する情報を格納します。
解説(Remarks)
nspapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に応じて、この関数の ANSI 版と Unicode 版を自動的に選択するエイリアスとして SERVICE_INFO を定義しています。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させると、不一致が生じてコンパイルエラーや実行時エラーの原因となる場合があります。詳細については、関数プロトタイプの規則 を参照してください。
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 Structureimport 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: BLOBstruct 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