Win32 API 日本語リファレンス
ホーム › System.WindowsProgramming › TDIObjectID

TDIObjectID

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 20 バイト / x86: 20 バイト

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

フィールド

フィールド型サイズx64x86説明
toi_entityTDIEntityID8+0+0TDIEntityID 構造体です。
toi_classDWORD4+8+8

要求する情報の種類です。次のいずれかの値を指定できます。

値 意味
INFO_CLASS_GENERIC
 現在のコンピューター上のすべての TDI エンティティの列挙を要求する場合、またはそれらの TDI エンティティのいずれかの型を判別する場合に使用します。
INFO_CLASS_PROTOCOL
 特定のインターフェイスまたは IP エンティティに関する情報を要求する場合に使用します。
toi_typeDWORD4+12+12

照会するオブジェクトの型です。次のいずれかの値を指定できます。

値 意味
INFO_TYPE_PROVIDER
 サービス プロバイダーです。IOCTL_TCP_QUERY_INFORMATION_EX のトピックで説明されているすべての照会は、この型の値を使用します。
INFO_TYPE_ADDRESS_OBJECT
 アドレス オブジェクトです。
INFO_TYPE_CONNECTION
 接続オブジェクトです。
toi_idDWORD4+16+16

toi_class が INFO_CLASS_GENERIC の場合、toi_id には次のいずれかを指定できます。

値 意味
ENTITY_LIST_ID
 ローカル コンピューター上のすべての TDI エンティティの一覧を返します。
ENTITY_TYPE_ID
 指定された TDI エンティティの型の値を返します。

toi_class が INFO_CLASS_PROTOCOL の場合、toi_id には次のいずれかを指定できます。

値 意味
IF_MIB_STATS_ID
 照会されるエンティティが MIB-II をサポートするインターフェイスである場合、そのインターフェイスに関する情報を格納した IFEntry 構造体を返します。
IP_MIB_STATS_ID
 照会されるエンティティがネットワーク層の IP エンティティである場合、そのエンティティに関する情報を格納した IPSNMPInfo 構造体を返します。
IP_MIB_ADDRTABLE_ENTRY_ID
 照会されるエンティティが 1 つ以上の IP アドレスが有効になっているネットワーク層の IP エンティティである場合、それらのアドレスに関する情報を格納した IPAddrEntry 構造体の配列を返します。
IP_INTFC_INFO_ID
 TCP_REQUEST_QUERY_INFORMATION_EX 構造体の Context メンバーで指定された特定の IP アドレスに関する情報を格納した IPInterfaceInfo 構造体を返します。

公式ドキュメント

[この構造体は、将来のバージョンの Windows で変更されるか、使用できなくなる可能性があります。]

IOCTL_TCP_QUERY_INFORMATION_EX 制御コードと共に使用され、TCP ドライバーに要求する情報の種類を指定する TCP_REQUEST_QUERY_INFORMATION_EX 構造体の一部を格納します。

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

各言語での定義

#include <windows.h>

// TDIEntityID  (x64 8 / x86 8 バイト)
typedef struct TDIEntityID {
    TDIENTITY_ENTITY_TYPE tei_entity;
    DWORD tei_instance;
} TDIEntityID;

// TDIObjectID  (x64 20 / x86 20 バイト)
typedef struct TDIObjectID {
    TDIEntityID toi_entity;
    DWORD toi_class;
    DWORD toi_type;
    DWORD toi_id;
} TDIObjectID;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct TDIEntityID
{
    public uint tei_entity;
    public uint tei_instance;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct TDIObjectID
{
    public TDIEntityID toi_entity;
    public uint toi_class;
    public uint toi_type;
    public uint toi_id;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure TDIEntityID
    Public tei_entity As UInteger
    Public tei_instance As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure TDIObjectID
    Public toi_entity As TDIEntityID
    Public toi_class As UInteger
    Public toi_type As UInteger
    Public toi_id As UInteger
End Structure
import ctypes
from ctypes import wintypes

class TDIEntityID(ctypes.Structure):
    _fields_ = [
        ("tei_entity", wintypes.DWORD),
        ("tei_instance", wintypes.DWORD),
    ]

class TDIObjectID(ctypes.Structure):
    _fields_ = [
        ("toi_entity", TDIEntityID),
        ("toi_class", wintypes.DWORD),
        ("toi_type", wintypes.DWORD),
        ("toi_id", wintypes.DWORD),
    ]
#[repr(C)]
pub struct TDIEntityID {
    pub tei_entity: u32,
    pub tei_instance: u32,
}

#[repr(C)]
pub struct TDIObjectID {
    pub toi_entity: TDIEntityID,
    pub toi_class: u32,
    pub toi_type: u32,
    pub toi_id: u32,
}
import "golang.org/x/sys/windows"

type TDIEntityID struct {
	tei_entity uint32
	tei_instance uint32
}

type TDIObjectID struct {
	toi_entity TDIEntityID
	toi_class uint32
	toi_type uint32
	toi_id uint32
}
type
  TDIEntityID = record
    tei_entity: DWORD;
    tei_instance: DWORD;
  end;

  TDIObjectID = record
    toi_entity: TDIEntityID;
    toi_class: DWORD;
    toi_type: DWORD;
    toi_id: DWORD;
  end;
const TDIEntityID = extern struct {
    tei_entity: u32,
    tei_instance: u32,
};

const TDIObjectID = extern struct {
    toi_entity: TDIEntityID,
    toi_class: u32,
    toi_type: u32,
    toi_id: u32,
};
type
  TDIEntityID {.bycopy.} = object
    tei_entity: uint32
    tei_instance: uint32

  TDIObjectID {.bycopy.} = object
    toi_entity: TDIEntityID
    toi_class: uint32
    toi_type: uint32
    toi_id: uint32
struct TDIEntityID
{
    uint tei_entity;
    uint tei_instance;
}

struct TDIObjectID
{
    TDIEntityID toi_entity;
    uint toi_class;
    uint toi_type;
    uint toi_id;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; TDIObjectID サイズ: 20 バイト(x64)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; toi_entity : TDIEntityID (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; toi_class : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; toi_type : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; toi_id : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global TDIEntityID
    #field int tei_entity
    #field int tei_instance
#endstruct

#defstruct global TDIObjectID
    #field TDIEntityID toi_entity
    #field int toi_class
    #field int toi_type
    #field int toi_id
#endstruct

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