Win32 API 日本語リファレンス
ホームNetworkManagement.NetBios › ACTION_HEADER

ACTION_HEADER

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

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

フィールド

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

トランスポート プロバイダーを指定します。このメンバーは、トランスポートが要求の妥当性を確認するために使用できます。

このメンバーは常に 4 文字の文字列です。文字 M で始まる文字列はすべて予約済みです。次の例を参照してください。

MOOO (すべてのトランスポート)

MNBF (NBF)

MABF (AsyBEUI)

MXNS (XNS)

Windows XP: NetBEUI を含む一部の従来のネットワーク プロトコルは、今後サポートされません。

action_codeWORD2+4+4アクションを指定します。
reservedWORD2+6+6予約済みです。

公式ドキュメント

[Netbios は Windows Vista、Windows Server 2008、およびそれ以降のバージョンのオペレーティング システムではサポートされていません]

ACTION_HEADER 構造体は、アクションに関する情報を格納します。このアクションは、標準のトランスポート インターフェイスに対する拡張です。

解説(Remarks)

アクションの適用範囲は、NCB 構造体の ncb_lsn メンバーと ncb_num メンバーによって、次のように決まります。

ncb_lsn = 0 ncb_lsn != 0
ncb_num = 0 アクションは、有効な LAN アダプターに関連付けられた制御チャネルに適用されます。 アクションは、有効なローカル セッション番号に関連付けられた接続識別子に適用されます。
ncb_num != 0 アクションは、有効な LAN アダプターに関連付けられたアドレスに適用されます。 指定できない組み合わせです。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// ACTION_HEADER  (x64 8 / x86 8 バイト)
typedef struct ACTION_HEADER {
    DWORD transport_id;
    WORD action_code;
    WORD reserved;
} ACTION_HEADER;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ACTION_HEADER
{
    public uint transport_id;
    public ushort action_code;
    public ushort reserved;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ACTION_HEADER
    Public transport_id As UInteger
    Public action_code As UShort
    Public reserved As UShort
End Structure
import ctypes
from ctypes import wintypes

class ACTION_HEADER(ctypes.Structure):
    _fields_ = [
        ("transport_id", wintypes.DWORD),
        ("action_code", ctypes.c_ushort),
        ("reserved", ctypes.c_ushort),
    ]
#[repr(C)]
pub struct ACTION_HEADER {
    pub transport_id: u32,
    pub action_code: u16,
    pub reserved: u16,
}
import "golang.org/x/sys/windows"

type ACTION_HEADER struct {
	transport_id uint32
	action_code uint16
	reserved uint16
}
type
  ACTION_HEADER = record
    transport_id: DWORD;
    action_code: Word;
    reserved: Word;
  end;
const ACTION_HEADER = extern struct {
    transport_id: u32,
    action_code: u16,
    reserved: u16,
};
type
  ACTION_HEADER {.bycopy.} = object
    transport_id: uint32
    action_code: uint16
    reserved: uint16
struct ACTION_HEADER
{
    uint transport_id;
    ushort action_code;
    ushort reserved;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ACTION_HEADER サイズ: 8 バイト(x64)
dim st, 2    ; 4byte整数×2(構造体サイズ 8 / 4 切り上げ)
; transport_id : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; action_code : WORD (+4, 2byte)  wpoke st,4,値  /  値 = wpeek(st,4)
; reserved : WORD (+6, 2byte)  wpoke st,6,値  /  値 = wpeek(st,6)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global ACTION_HEADER
    #field int transport_id
    #field short action_code
    #field short reserved
#endstruct

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