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

AsnAny

構造体
サイズx64: 20 バイト / x86: 16 バイトパッキング4

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

フィールド

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

変数の型を示します。このメンバーは、次のいずれか 1 つの値でなければなりません。

意味
ASN_INTEGER
32 ビット符号付き整数の変数を示します。
ASN_INTEGER32
32 ビット符号付き整数の変数を示します。
ASN_UNSIGNED32
32 ビット符号なし整数の変数を示します。詳細については、後述の「解説」セクションを参照してください。
ASN_COUNTER64
最大値 (2^64) – 1 に達するまで増加するカウンター変数を示します。
ASN_OCTETSTRING
オクテット文字列の変数を示します。
ASN_BITS
名前付きビットの列挙である変数を示します。
ASN_OBJECTIDENTIFIER
オブジェクト識別子の変数を示します。
ASN_SEQUENCE
ASN シーケンスの変数を示します。
ASN_IPADDRESS
IP アドレスの変数を示します。
ASN_COUNTER32
カウンター変数を示します。
ASN_GAUGE32
ゲージ変数を示します。詳細については、後述の「解説」セクションを参照してください。
ASN_TIMETICKS
タイムティック変数を示します。
ASN_OPAQUE
不透明 (opaque) 変数を示します。
SNMP_EXCEPTION_NOSUCHOBJECT
指定されたオブジェクトが利用できないことを示します。
SNMP_EXCEPTION_NOSUCHINSTANCE
指定されたインスタンスが利用できないことを示します。
SNMP_EXCEPTION_ENDOFMIBVIEW
MIB ビューの末尾に達したことを示します。
asnValue_asnValue_e__Union16/12+4+4

変数の値を格納します。このメンバーは、次のいずれか 1 つの値のみを取ります。

number

Type: AsnInteger32

32 ビット符号付き整数の変数にアクセスします。

unsigned32

Type: AsnUnsigned32

32 ビット符号なし整数の変数にアクセスします。

counter64

Type: AsnCounter64

最大値 (2^64) – 1 に達するまで増加するカウンター変数にアクセスします。

string

Type: AsnOctetString

オクテット文字列の変数にアクセスします。

bits

Type: AsnBits

0 から始まる負でない連続した値を持つ、名前付きビットの列挙である変数にアクセスします。

object

Type: AsnObjectIdentifier

オブジェクト識別子の変数にアクセスします。

sequence

Type: AsnSequence

ASN シーケンスの変数にアクセスします。

address

Type: AsnIPAddress

IP アドレスの変数にアクセスします。

counter

Type: AsnCounter32

最大値 (2^32) – 1 に達するまで増加するカウンター変数にアクセスします。

gauge

Type: AsnGauge32

ゲージ変数にアクセスします。

ticks

Type: AsnTimeticks

特定のタイマー イベントを基準とするタイムティック カウンター変数にアクセスします。

arbitrary

Type: AsnOpaque

不透明 (opaque) 変数にアクセスします。

共用体: _asnValue_e__Union x64 16B / x86 12B

フィールドサイズx64x86
numberINT4+0+0
unsigned32DWORD4+0+0
counter64ULONGLONG8+0+0
stringAsnOctetString16/12+0+0
bitsAsnOctetString16/12+0+0
objectAsnObjectIdentifier12/8+0+0
sequenceAsnOctetString16/12+0+0
addressAsnOctetString16/12+0+0
counterDWORD4+0+0
gaugeDWORD4+0+0
ticksDWORD4+0+0
arbitraryAsnOctetString16/12+0+0

公式ドキュメント

[SNMP は、「要件」セクションに記載されたオペレーティング システムで使用できます。以降のバージョンでは変更または利用不可になる可能性があります。代わりに、WS-Man の Microsoft 実装である Windows リモート管理を使用してください。]

AsnAny 構造体は、SNMP 変数の型と値を格納します。この構造体は、多くの SNMP 関数でパラメーターとして使用される SnmpVarBind 構造体のメンバーです。この構造体は WinSNMP API 関数では使用されません。

解説(Remarks)

RFC 1902 に記載されている Unsigned32 型の定義を使用するには、ASN_GAUGE32 変数型を指定できます。現在、ASN_UNSIGNED32 変数型は RFC 1442 に記載されている UInteger32 型を指定します。

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

各言語での定義

#include <windows.h>

// AsnAny  (x64 20 / x86 16 バイト)
#pragma pack(push, 4)
typedef struct AsnAny {
    BYTE asnType;
    _asnValue_e__Union asnValue;
} AsnAny;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 4, CharSet = CharSet.Unicode)]
public struct AsnAny
{
    public byte asnType;
    public _asnValue_e__Union asnValue;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=4, CharSet:=CharSet.Unicode)>
Public Structure AsnAny
    Public asnType As Byte
    Public asnValue As _asnValue_e__Union
End Structure
import ctypes
from ctypes import wintypes

class AsnAny(ctypes.Structure):
    _pack_ = 4
    _fields_ = [
        ("asnType", ctypes.c_ubyte),
        ("asnValue", _asnValue_e__Union),
    ]
#[repr(C, packed(4))]
pub struct AsnAny {
    pub asnType: u8,
    pub asnValue: _asnValue_e__Union,
}
import "golang.org/x/sys/windows"

type AsnAny struct {
	asnType byte
	asnValue _asnValue_e__Union
}
type
  AsnAny = packed record
    asnType: Byte;
    asnValue: _asnValue_e__Union;
  end;
const AsnAny = extern struct {
    asnType: u8,
    asnValue: _asnValue_e__Union,
};
type
  AsnAny {.packed.} = object
    asnType: uint8
    asnValue: _asnValue_e__Union
align(4)
struct AsnAny
{
    ubyte asnType;
    _asnValue_e__Union asnValue;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; AsnAny サイズ: 16 バイト(x86)
dim st, 4    ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; asnType : BYTE (+0, 1byte)  poke st,0,値  /  値 = peek(st,0)
; asnValue : _asnValue_e__Union (+4, 12byte)  varptr(st)+4 を基点に操作(12byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; AsnAny サイズ: 20 バイト(x64)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; asnType : BYTE (+0, 1byte)  poke st,0,値  /  値 = peek(st,0)
; asnValue : _asnValue_e__Union (+4, 16byte)  varptr(st)+4 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global AsnAny, pack=4
    #field byte asnType
    #field byte asnValue 16
#endstruct

stdim st, AsnAny        ; NSTRUCT 変数を確保
st->asnType = 100
mes "asnType=" + st->asnType
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。