smiVALUE 構造体 (winsnmp.h)

[アーティクル]
03/13/2024

[SNMP は、[要件] セクションで指定されたオペレーティングシステムで使用できます。今後のバージョンでは変更されるか、利用できなくなる場合もあります。代わりに、WS-Man の Microsoft 実装である Windows リモート管理を使用します。

WinSNMP smiVALUE 構造体は、変数バインドエントリ内の変数名に関連付けられている値を記述します。

smiVALUE 構造体の構文メンバーには、値メンバー内のデータ型を示す WinSNMP データ型が含まれています。構造体の value メンバーは、考えられるすべての WinSNMP データ型の和集合です。

構文

typedef struct {
  smiUINT32 syntax;
  union {
    smiINT    sNumber;
    smiUINT32 uNumber;
    smiCNTR64 hNumber;
    smiOCTETS string;
    smiOID    oid;
    smiBYTE   empty;
  } value;
} smiVALUE, *smiLPVALUE;

メンバー

syntax

種類: smiUINT32

値メンバーの構文データ型を示す符号なし長整数を指定します。このメンバーは、次の表に示す型のいずれか 1 つだけです。詳細については、 WinSNMP データ型と RFC 1902「Simple Network Management Protocol (SNMPv2) のバージョン 2 の管理情報の構造」を参照してください。

構文データ型	意味
SNMP_SYNTAX_INT	32 ビット符号付き整数変数を示します。
SNMP_SYNTAX_OCTETS	バイナリデータまたはテキストデータであるオクテット文字列変数を示します。
SNMP_SYNTAX_NULL	NULL 値を示します。
SNMP_SYNTAX_OID	最大 128 個のサブ識別子を持つ割り当てられた名前であるオブジェクト識別子変数を示します。
SNMP_SYNTAX_INT32	32 ビット符号付き整数変数を示します。
SNMP_SYNTAX_IPADDR	32 ビットのインターネットアドレス変数を示します。
SNMP_SYNTAX_CNTR32	最大値 (2^32) – 1 に達するまで増加するカウンター変数を示します。
SNMP_SYNTAX_GAUGE32	ゲージ変数を示します。負以外の整数で、増減はできますが、最大値を超えることはありません。
SNMP_SYNTAX_TIMETICKS	最大値 (2^32) – 1 に達するまでの時間を 1 秒の 100 分の 1 で測定するカウンター変数を示します。これは、特定のタイマーイベントを基準とした負以外の整数です。
SNMP_SYNTAX_OPAQUE	この型は下位互換性を提供し、新しいオブジェクト型には使用しないでください。任意の抽象構文表記 1 (ASN.1) 構文を渡す機能がサポートされています。
SNMP_SYNTAX_CNTR64	最大値 (2^64) – 1 に達するまで増加するカウンター変数を示します。
SNMP_SYNTAX_UINT32	32 ビット符号なし整数変数を示します。
SNMP_SYNTAX_NOSUCHOBJECT	エージェントが変数に対応するオブジェクト型をサポートしていないことを示します。
SNMP_SYNTAX_NOSUCHINSTANCE	操作にオブジェクトインスタンスが存在しないことを示します。
SNMP_SYNTAX_ENDOFMIBVIEW	WinSNMP アプリケーションが、エージェントがサポートする MIB ツリーの末尾を超えるオブジェクト識別子を参照しようとしていることを示します。

最後の 3 つの構文の種類では、SNMP バージョン 2C (SNMPv2C) フレームワークでの例外条件について説明します。

value

smiOID 記述子型または smiOCTETS 記述子型を含む、考えられるすべての WinSNMP 構文データ型の和集合を指定します。

sNumber

型: smiINT 符号付き長整数を指定します。

uNumber

種類: smiUINT32 32 ビット符号なし長整数を指定します。

hNumber

種類: smiCNTR64 64 ビット符号なし整数値を指定します

string

種類: smiOCTETS 文字列を指定します。

oid

種類: smiOID オブジェクト識別子 (OID) を指定します。

empty

型: smiBYTE 空のメンバーを指定します。

value.sNumber

value.uNumber

value.hNumber

value.string

value.oid

value.empty

注釈

WinSNMP アプリケーションでは、値メンバーを正しく逆参照するには、smiVALUE 構造体の構文メンバーをチェックする必要があります。値メンバーには、単純なスカラー値、または smiOCTETS や smiOID 記述子構造体などの非スカラー値を含めることができます。

構文メンバーが値メンバーが smiOCTETS または smiOID 記述子構造体であることを示す場合、WinSNMP アプリケーションは、構造体に割り当てられたリソースを解放するかどうかを決定する必要があります。 Microsoft WinSNMP 実装では、すべての出力 smiOCTETS および smiOID 構造体に対してメモリの割り当てと割り当てを解除します。これらの構造体の ptr メンバーのメモリを解放するには、アプリケーションで SnmpFreeDescriptor 関数を呼び出す必要があります。

WinSNMP アプリケーションは、可変長の入力記述子にメモリを割り当てるので、そのメモリを解放する必要があります。詳細については、「WinSNMP データ管理の概念」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
Header	winsnmp.h