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

NSP_ROUTINE

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

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0構造体のサイズ (バイト単位)。NSP_ROUTINE 構造体のサイズは Windows XP 以降で変更されている点に注意してください。
dwMajorVersionDWORD4+4+4このプロバイダーがサポートするサービス プロバイダー仕様のメジャー バージョンです。
dwMinorVersionDWORD4+8+8このプロバイダーがサポートするサービス プロバイダー仕様のマイナー バージョンです。
NSPCleanupLPNSPCLEANUP8/4+16+12ネームスペース プロバイダーが実装する NSPCleanup 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPCleanup 関数は WSAEOPNOTSUPP を返す必要があります。
NSPLookupServiceBeginLPNSPLOOKUPSERVICEBEGIN8/4+24+16ネームスペース プロバイダーが実装する NSPLookupServiceBegin 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPLookupServiceBegin 関数は WSAEOPNOTSUPP を返す必要があります。
NSPLookupServiceNextLPNSPLOOKUPSERVICENEXT8/4+32+20ネームスペース プロバイダーが実装する NSPLookupServiceNext 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPLookupServiceNext 関数は WSAEOPNOTSUPP を返す必要があります。
NSPLookupServiceEndLPNSPLOOKUPSERVICEEND8/4+40+24ネームスペース プロバイダーが実装する NSPLookupServiceEnd 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPLookupServiceEnd 関数は WSAEOPNOTSUPP を返す必要があります。
NSPSetServiceLPNSPSETSERVICE8/4+48+28ネームスペース プロバイダーが実装する NSPSetService 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPSetService 関数は WSAEOPNOTSUPP を返す必要があります。
NSPInstallServiceClassLPNSPINSTALLSERVICECLASS8/4+56+32ネームスペース プロバイダーが実装する NSPInstallServiceClass 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPInstallServiceClass 関数は WSAEOPNOTSUPP を返す必要があります。
NSPRemoveServiceClassLPNSPREMOVESERVICECLASS8/4+64+36ネームスペース プロバイダーが実装する NSPRemoveServiceClass 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPRemoveServiceClass 関数は WSAEOPNOTSUPP を返す必要があります。
NSPGetServiceClassInfoLPNSPGETSERVICECLASSINFO8/4+72+40ネームスペース プロバイダーが実装する NSPGetServiceClassInfo 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPGetServiceClassInfo 関数は WSAEOPNOTSUPP を返す必要があります。
NSPIoctlLPNSPIOCTL8/4+80+44

ネームスペース プロバイダーが実装する NSPIoctl 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPIoctl 関数は WSAEOPNOTSUPP を返す必要があります。

**メモ** この構造体メンバーは、Windows XP 以降でのみ使用できます。

公式ドキュメント

NSP_ROUTINE 構造体は、ネームスペース サービス プロバイダー バージョン 1 (NSPv1) プロバイダーが実装する関数に関する情報を格納します。

**メモ** Ws2spi.h ヘッダー ファイル内の構造体には、すべての NSPv1 関数ポインターの完全なプロトタイプが含まれています。

解説(Remarks)

NSP_ROUTINE 構造体のサイズは Windows XP 以降で変更されました。使用されている NSP_ROUTINE 構造体のバージョンを判別するには、cbSize メンバーを使用してください。

Windows XP 以降のバージョンの NSP_ROUTINE 構造体には、新しいメンバーとして NSPIoctl が追加されています。

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

各言語での定義

#include <windows.h>

// NSP_ROUTINE  (x64 88 / x86 48 バイト)
typedef struct NSP_ROUTINE {
    DWORD cbSize;
    DWORD dwMajorVersion;
    DWORD dwMinorVersion;
    LPNSPCLEANUP NSPCleanup;
    LPNSPLOOKUPSERVICEBEGIN NSPLookupServiceBegin;
    LPNSPLOOKUPSERVICENEXT NSPLookupServiceNext;
    LPNSPLOOKUPSERVICEEND NSPLookupServiceEnd;
    LPNSPSETSERVICE NSPSetService;
    LPNSPINSTALLSERVICECLASS NSPInstallServiceClass;
    LPNSPREMOVESERVICECLASS NSPRemoveServiceClass;
    LPNSPGETSERVICECLASSINFO NSPGetServiceClassInfo;
    LPNSPIOCTL NSPIoctl;
} NSP_ROUTINE;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NSP_ROUTINE
{
    public uint cbSize;
    public uint dwMajorVersion;
    public uint dwMinorVersion;
    public IntPtr NSPCleanup;
    public IntPtr NSPLookupServiceBegin;
    public IntPtr NSPLookupServiceNext;
    public IntPtr NSPLookupServiceEnd;
    public IntPtr NSPSetService;
    public IntPtr NSPInstallServiceClass;
    public IntPtr NSPRemoveServiceClass;
    public IntPtr NSPGetServiceClassInfo;
    public IntPtr NSPIoctl;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NSP_ROUTINE
    Public cbSize As UInteger
    Public dwMajorVersion As UInteger
    Public dwMinorVersion As UInteger
    Public NSPCleanup As IntPtr
    Public NSPLookupServiceBegin As IntPtr
    Public NSPLookupServiceNext As IntPtr
    Public NSPLookupServiceEnd As IntPtr
    Public NSPSetService As IntPtr
    Public NSPInstallServiceClass As IntPtr
    Public NSPRemoveServiceClass As IntPtr
    Public NSPGetServiceClassInfo As IntPtr
    Public NSPIoctl As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class NSP_ROUTINE(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("dwMajorVersion", wintypes.DWORD),
        ("dwMinorVersion", wintypes.DWORD),
        ("NSPCleanup", ctypes.c_void_p),
        ("NSPLookupServiceBegin", ctypes.c_void_p),
        ("NSPLookupServiceNext", ctypes.c_void_p),
        ("NSPLookupServiceEnd", ctypes.c_void_p),
        ("NSPSetService", ctypes.c_void_p),
        ("NSPInstallServiceClass", ctypes.c_void_p),
        ("NSPRemoveServiceClass", ctypes.c_void_p),
        ("NSPGetServiceClassInfo", ctypes.c_void_p),
        ("NSPIoctl", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct NSP_ROUTINE {
    pub cbSize: u32,
    pub dwMajorVersion: u32,
    pub dwMinorVersion: u32,
    pub NSPCleanup: *mut core::ffi::c_void,
    pub NSPLookupServiceBegin: *mut core::ffi::c_void,
    pub NSPLookupServiceNext: *mut core::ffi::c_void,
    pub NSPLookupServiceEnd: *mut core::ffi::c_void,
    pub NSPSetService: *mut core::ffi::c_void,
    pub NSPInstallServiceClass: *mut core::ffi::c_void,
    pub NSPRemoveServiceClass: *mut core::ffi::c_void,
    pub NSPGetServiceClassInfo: *mut core::ffi::c_void,
    pub NSPIoctl: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type NSP_ROUTINE struct {
	cbSize uint32
	dwMajorVersion uint32
	dwMinorVersion uint32
	NSPCleanup uintptr
	NSPLookupServiceBegin uintptr
	NSPLookupServiceNext uintptr
	NSPLookupServiceEnd uintptr
	NSPSetService uintptr
	NSPInstallServiceClass uintptr
	NSPRemoveServiceClass uintptr
	NSPGetServiceClassInfo uintptr
	NSPIoctl uintptr
}
type
  NSP_ROUTINE = record
    cbSize: DWORD;
    dwMajorVersion: DWORD;
    dwMinorVersion: DWORD;
    NSPCleanup: Pointer;
    NSPLookupServiceBegin: Pointer;
    NSPLookupServiceNext: Pointer;
    NSPLookupServiceEnd: Pointer;
    NSPSetService: Pointer;
    NSPInstallServiceClass: Pointer;
    NSPRemoveServiceClass: Pointer;
    NSPGetServiceClassInfo: Pointer;
    NSPIoctl: Pointer;
  end;
const NSP_ROUTINE = extern struct {
    cbSize: u32,
    dwMajorVersion: u32,
    dwMinorVersion: u32,
    NSPCleanup: ?*anyopaque,
    NSPLookupServiceBegin: ?*anyopaque,
    NSPLookupServiceNext: ?*anyopaque,
    NSPLookupServiceEnd: ?*anyopaque,
    NSPSetService: ?*anyopaque,
    NSPInstallServiceClass: ?*anyopaque,
    NSPRemoveServiceClass: ?*anyopaque,
    NSPGetServiceClassInfo: ?*anyopaque,
    NSPIoctl: ?*anyopaque,
};
type
  NSP_ROUTINE {.bycopy.} = object
    cbSize: uint32
    dwMajorVersion: uint32
    dwMinorVersion: uint32
    NSPCleanup: pointer
    NSPLookupServiceBegin: pointer
    NSPLookupServiceNext: pointer
    NSPLookupServiceEnd: pointer
    NSPSetService: pointer
    NSPInstallServiceClass: pointer
    NSPRemoveServiceClass: pointer
    NSPGetServiceClassInfo: pointer
    NSPIoctl: pointer
struct NSP_ROUTINE
{
    uint cbSize;
    uint dwMajorVersion;
    uint dwMinorVersion;
    void* NSPCleanup;
    void* NSPLookupServiceBegin;
    void* NSPLookupServiceNext;
    void* NSPLookupServiceEnd;
    void* NSPSetService;
    void* NSPInstallServiceClass;
    void* NSPRemoveServiceClass;
    void* NSPGetServiceClassInfo;
    void* NSPIoctl;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NSP_ROUTINE サイズ: 48 バイト(x86)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwMajorVersion : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwMinorVersion : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; NSPCleanup : LPNSPCLEANUP (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; NSPLookupServiceBegin : LPNSPLOOKUPSERVICEBEGIN (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; NSPLookupServiceNext : LPNSPLOOKUPSERVICENEXT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; NSPLookupServiceEnd : LPNSPLOOKUPSERVICEEND (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; NSPSetService : LPNSPSETSERVICE (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; NSPInstallServiceClass : LPNSPINSTALLSERVICECLASS (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; NSPRemoveServiceClass : LPNSPREMOVESERVICECLASS (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; NSPGetServiceClassInfo : LPNSPGETSERVICECLASSINFO (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; NSPIoctl : LPNSPIOCTL (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NSP_ROUTINE サイズ: 88 バイト(x64)
dim st, 22    ; 4byte整数×22(構造体サイズ 88 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwMajorVersion : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwMinorVersion : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; NSPCleanup : LPNSPCLEANUP (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; NSPLookupServiceBegin : LPNSPLOOKUPSERVICEBEGIN (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; NSPLookupServiceNext : LPNSPLOOKUPSERVICENEXT (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; NSPLookupServiceEnd : LPNSPLOOKUPSERVICEEND (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; NSPSetService : LPNSPSETSERVICE (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; NSPInstallServiceClass : LPNSPINSTALLSERVICECLASS (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; NSPRemoveServiceClass : LPNSPREMOVESERVICECLASS (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; NSPGetServiceClassInfo : LPNSPGETSERVICECLASSINFO (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; NSPIoctl : LPNSPIOCTL (+80, 8byte)  qpoke st,80,値 / qpeek(st,80)  ※IronHSPのみ。3.7/3.8は lpoke st,80,下位 : lpoke st,84,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global NSP_ROUTINE
    #field int cbSize
    #field int dwMajorVersion
    #field int dwMinorVersion
    #field intptr NSPCleanup
    #field intptr NSPLookupServiceBegin
    #field intptr NSPLookupServiceNext
    #field intptr NSPLookupServiceEnd
    #field intptr NSPSetService
    #field intptr NSPInstallServiceClass
    #field intptr NSPRemoveServiceClass
    #field intptr NSPGetServiceClassInfo
    #field intptr NSPIoctl
#endstruct

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