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

NS_SERVICE_INFOW

構造体
サイズx64: 88 バイト / x86: 48 バイト

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

フィールド

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

このサービス情報が適用される名前空間、または既定の名前空間のセットです。

名前空間を指定するには、次のいずれかの定数値を使用します。

意味
NS_DEFAULT
既定の名前空間のセットです。既定の名前空間のセットには、通常、システムにインストールされているすべての名前空間が含まれます。ただし、システム管理者は特定の名前空間をこのセットから除外できます。
NS_DNS
ホスト名を解決するためにインターネットで使用されるドメインネームシステムです。
NS_MS
Microsoft の名前空間です。
NS_NDS
NetWare 4 プロバイダーです。
NS_NETBT
NetBIOS over TCP/IP レイヤーです。オペレーティングシステムは、コンピューター名を NetBIOS に登録します。この名前空間は、この登録を利用してコンピューター名を IP アドレスに変換するために使用されます。
NS_NIS
NS_SAP
NetWare Service Advertising Protocol です。必要に応じて NetWare のバインダリにアクセスできます。NS_SAP は、サービスの登録を可能にする動的な名前空間です。
NS_STDA
NS_TCPIP_HOSTS
<systemroot>\system32\drivers\etc\posts ファイル内の値を検索します。
NS_TCPIP_LOCAL
ローカルの TCP/IP 名前解決メカニズムです。ローカルホスト名との比較や、ホストと IP アドレスのマッピングのキャッシュ内の値の検索が含まれます。
NS_WINS
Windows インターネットネームシステム (WINS) の名前空間です。
NS_X500
X.500 ディレクトリサービスの名前空間です。
ServiceInfoSERVICE_INFOW80/44+8+4ネットワークサービスまたはネットワークサービスの種類に関する情報を格納する SERVICE_INFO 構造体です。

公式ドキュメント

NS_SERVICE_INFO 構造体は、指定された名前空間のコンテキスト、または既定の名前空間のセットにおける、ネットワークサービスまたはネットワークサービスの種類に関する情報を格納します。

解説(Remarks)

メモ

nspapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版と Unicode 版を自動的に選択するエイリアスとして NS_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_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;

// NS_SERVICE_INFOW  (x64 88 / x86 48 バイト)
typedef struct NS_SERVICE_INFOW {
    DWORD dwNameSpace;
    SERVICE_INFOW ServiceInfo;
} NS_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;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NS_SERVICE_INFOW
{
    public uint dwNameSpace;
    public SERVICE_INFOW ServiceInfo;
}
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 Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NS_SERVICE_INFOW
    Public dwNameSpace As UInteger
    Public ServiceInfo As SERVICE_INFOW
End Structure
import 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),
    ]

class NS_SERVICE_INFOW(ctypes.Structure):
    _fields_ = [
        ("dwNameSpace", wintypes.DWORD),
        ("ServiceInfo", SERVICE_INFOW),
    ]
#[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,
}

#[repr(C)]
pub struct NS_SERVICE_INFOW {
    pub dwNameSpace: u32,
    pub ServiceInfo: SERVICE_INFOW,
}
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 NS_SERVICE_INFOW struct {
	dwNameSpace uint32
	ServiceInfo SERVICE_INFOW
}
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;

  NS_SERVICE_INFOW = record
    dwNameSpace: DWORD;
    ServiceInfo: SERVICE_INFOW;
  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,
};

const NS_SERVICE_INFOW = extern struct {
    dwNameSpace: u32,
    ServiceInfo: SERVICE_INFOW,
};
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: BLOB

  NS_SERVICE_INFOW {.bycopy.} = object
    dwNameSpace: uint32
    ServiceInfo: SERVICE_INFOW
struct 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;
}

struct NS_SERVICE_INFOW
{
    uint dwNameSpace;
    SERVICE_INFOW ServiceInfo;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NS_SERVICE_INFOW サイズ: 48 バイト(x86)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; dwNameSpace : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ServiceInfo : SERVICE_INFOW (+4, 44byte)  varptr(st)+4 を基点に操作(44byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NS_SERVICE_INFOW サイズ: 88 バイト(x64)
dim st, 22    ; 4byte整数×22(構造体サイズ 88 / 4 切り上げ)
; dwNameSpace : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ServiceInfo : SERVICE_INFOW (+8, 80byte)  varptr(st)+8 を基点に操作(80byte:入れ子/配列)
; ※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

#defstruct global NS_SERVICE_INFOW
    #field int dwNameSpace
    #field SERVICE_INFOW ServiceInfo
#endstruct

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