ホーム › Networking.WinSock › NSP_ROUTINE
NSP_ROUTINE
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| cbSize | DWORD | 4 | +0 | +0 | 構造体のサイズ (バイト単位)。NSP_ROUTINE 構造体のサイズは Windows XP 以降で変更されている点に注意してください。 |
| dwMajorVersion | DWORD | 4 | +4 | +4 | このプロバイダーがサポートするサービス プロバイダー仕様のメジャー バージョンです。 |
| dwMinorVersion | DWORD | 4 | +8 | +8 | このプロバイダーがサポートするサービス プロバイダー仕様のマイナー バージョンです。 |
| NSPCleanup | LPNSPCLEANUP | 8/4 | +16 | +12 | ネームスペース プロバイダーが実装する NSPCleanup 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPCleanup 関数は WSAEOPNOTSUPP を返す必要があります。 |
| NSPLookupServiceBegin | LPNSPLOOKUPSERVICEBEGIN | 8/4 | +24 | +16 | ネームスペース プロバイダーが実装する NSPLookupServiceBegin 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPLookupServiceBegin 関数は WSAEOPNOTSUPP を返す必要があります。 |
| NSPLookupServiceNext | LPNSPLOOKUPSERVICENEXT | 8/4 | +32 | +20 | ネームスペース プロバイダーが実装する NSPLookupServiceNext 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPLookupServiceNext 関数は WSAEOPNOTSUPP を返す必要があります。 |
| NSPLookupServiceEnd | LPNSPLOOKUPSERVICEEND | 8/4 | +40 | +24 | ネームスペース プロバイダーが実装する NSPLookupServiceEnd 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPLookupServiceEnd 関数は WSAEOPNOTSUPP を返す必要があります。 |
| NSPSetService | LPNSPSETSERVICE | 8/4 | +48 | +28 | ネームスペース プロバイダーが実装する NSPSetService 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPSetService 関数は WSAEOPNOTSUPP を返す必要があります。 |
| NSPInstallServiceClass | LPNSPINSTALLSERVICECLASS | 8/4 | +56 | +32 | ネームスペース プロバイダーが実装する NSPInstallServiceClass 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPInstallServiceClass 関数は WSAEOPNOTSUPP を返す必要があります。 |
| NSPRemoveServiceClass | LPNSPREMOVESERVICECLASS | 8/4 | +64 | +36 | ネームスペース プロバイダーが実装する NSPRemoveServiceClass 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPRemoveServiceClass 関数は WSAEOPNOTSUPP を返す必要があります。 |
| NSPGetServiceClassInfo | LPNSPGETSERVICECLASSINFO | 8/4 | +72 | +40 | ネームスペース プロバイダーが実装する NSPGetServiceClassInfo 関数へのポインターです。すべての NSP 関数エントリは、有効な関数を指していなければなりません。プロバイダーがこの関数を実装していない場合、NSPGetServiceClassInfo 関数は WSAEOPNOTSUPP を返す必要があります。 |
| NSPIoctl | LPNSPIOCTL | 8/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)
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 Structureimport 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: pointerstruct 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