smiVALUE 結構 (winsnmp.h)

發行項
03/04/2024

[SNMP 可用於需求一節中指定的作業系統。它在後續版本中可能會變更或無法使用。請改用 Windows 遠端管理，這是 WS-Man 的 Microsoft 實作。

WinSNMP smiVALUE 結構描述與變數系結專案中變數名稱相關聯的值。

smiVALUE 結構的語法成員包含 WinSNMP 數據類型，指出值成員中的數據類型。結構的值成員是所有可能 WinSNMP 數據類型的聯集。

語法

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

成員

syntax

類型： smiUINT32

指定不帶正負號的長整數，指出值成員的語法數據類型。此成員只能是下表所列的其中一種類型。如需詳細資訊，請參閱 WinSNMP 數據類型和 RFC 1902：「簡單網路管理通訊協定第 2 版的管理資訊結構 (SNMPv2) 」。

語法數據類型	意義
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 為止。它是相對於特定定時器事件的非負整數。
SNMP_SYNTAX_OPAQUE	此類型提供回溯相容性，不應用於新的物件類型。它支持傳遞任意抽象語法表示法 One (ASN.1) 語法的功能。
SNMP_SYNTAX_CNTR64	指出計數器變數，直到達到最大值 2^64 () - 1 為止。
SNMP_SYNTAX_UINT32	表示32位無符號整數變數。
SNMP_SYNTAX_NOSUCHOBJECT	表示代理程式不支持對應至變數的物件類型。
SNMP_SYNTAX_NOSUCHINSTANCE	表示作業的物件實例不存在。
SNMP_SYNTAX_ENDOFMIBVIEW	指出 WinSNMP 應用程式嘗試參考物件標識碼，該標識元超出代理程式所支援的 MIB 樹狀結構結尾。

最後三種語法類型描述SNMP 第 2C 版 (SNMPv2C) 架構下的例外狀況。

value

指定所有可能 WinSNMP 語法數據類型的聯集，包括 smiOID 或 smiOCTETS 描述元類型。

sNumber

類型： smiINT 指定帶正負號的長整數值。

uNumber

類型： smiUINT32 指定32位無符號長整數值。

hNumber

類型： smiCNTR64 指定 64 位無符號整數值

字串

類型： 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 結構的記憶體。應用程式必須呼叫 SnmpFreeDescriptor 函式，以釋放這些結構的 ptr 成員的記憶體。

由於 WinSNMP 應用程式會為具有可變長度的輸入描述元配置記憶體，因此必須釋放該記憶體。如需詳細資訊，請參閱 WinSNMP 資料管理概念。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	winsnmp.h