SERVICE_INFOW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| lpServiceType | GUID* | 8/4 | +0 | +0 | ネットワークサービスの種類を表す GUID へのポインターです。 | ||||||||||||||||
| lpServiceName | LPWSTR | 8/4 | +8 | +4 | ネットワークサービスの名前を表す NULL 終端文字列へのポインターです。 dwNameSpace パラメーターに NS_DEFAULT を指定して SetService 関数を呼び出す場合、ネットワークサービス名は共通名 (common name) でなければなりません。共通名とは、そのネットワークサービスが一般に知られている名前です。ネットワークサービスの共通名の例としては "My SQL Server" があります。 dwNameSpace パラメーターに特定のサービス名を指定して SetService 関数を呼び出す場合、ネットワークサービス名には共通名または識別名 (distinguished name) を指定できます。識別名は、ディレクトリサービス内の一意の場所にサービスを特定するものです。ネットワークサービスの識別名の例としては "MS\SYS\NT\DEV\My SQL Server" があります。 | ||||||||||||||||
| lpComment | LPWSTR | 8/4 | +16 | +8 | ネットワークサービスに対するコメントまたは説明を表す NULL 終端文字列へのポインターです。たとえば "Used for development upgrades." のような文字列です。 | ||||||||||||||||
| lpLocale | LPWSTR | 8/4 | +24 | +12 | ロケール情報を格納する NULL 終端文字列へのポインターです。 | ||||||||||||||||
| dwDisplayHint | RESOURCE_DISPLAY_TYPE | 4 | +32 | +16 | ネットワーク参照用のユーザーインターフェイスでネットワークサービスをどのように表示するかを示すヒントです。次の値のいずれかを指定できます。
| ||||||||||||||||
| dwVersion | DWORD | 4 | +36 | +20 | ネットワークサービスのバージョンです。この値の上位ワードはメジャーバージョン番号を、下位ワードはマイナーバージョン番号を指定します。 | ||||||||||||||||
| dwTime | DWORD | 4 | +40 | +24 | 将来の使用のために予約済みです。0 でなければなりません。 | ||||||||||||||||
| lpMachineName | LPWSTR | 8/4 | +48 | +28 | ネットワークサービスが実行されているコンピューターの名前を表す NULL 終端文字列へのポインターです。 | ||||||||||||||||
| lpServiceAddress | SERVICE_ADDRESSES* | 8/4 | +56 | +32 | SERVICE_ADDRESS 構造体の配列を格納する SERVICE_ADDRESSES 構造体へのポインターです。各 SERVICE_ADDRESS 構造体には、1 つのネットワークサービスアドレスに関する情報が格納されます。 ネットワークサービスは 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 を定義しています。エンコーディング中立なエイリアスと、エンコーディング中立でないコードを混在させると、不一致が生じてコンパイルエラーや実行時エラーの原因になることがあります。詳細については、Conventions for Function Prototypes を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// BLOB (x64 16 / x86 8 バイト)
typedef struct BLOB {
DWORD cbSize;
BYTE* pBlobData;
} BLOB;
// SERVICE_INFOW (x64 80 / x86 44 バイト)
typedef struct SERVICE_INFOW {
GUID* lpServiceType;
LPWSTR lpServiceName;
LPWSTR lpComment;
LPWSTR lpLocale;
RESOURCE_DISPLAY_TYPE dwDisplayHint;
DWORD dwVersion;
DWORD dwTime;
LPWSTR lpMachineName;
SERVICE_ADDRESSES* lpServiceAddress;
BLOB ServiceSpecificInfo;
} SERVICE_INFOW;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_INFOW
{
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_INFOW
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_INFOW(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_INFOW {
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_INFOW 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_INFOW = 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_INFOW = 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_INFOW {.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_INFOW
{
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_INFOW サイズ: 44 バイト(x86)
dim st, 11 ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; lpServiceType : GUID* (+0, 4byte) varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; lpServiceName : LPWSTR (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; lpComment : LPWSTR (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; lpLocale : LPWSTR (+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 : LPWSTR (+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_INFOW サイズ: 80 バイト(x64)
dim st, 20 ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; lpServiceType : GUID* (+0, 8byte) varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; lpServiceName : LPWSTR (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; lpComment : LPWSTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; lpLocale : LPWSTR (+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 : LPWSTR (+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_INFOW
#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_INFOW ; NSTRUCT 変数を確保
st->dwDisplayHint = 100
mes "dwDisplayHint=" + st->dwDisplayHint