struttura smiVALUE (winsnmp.h)

Articolo
03/04/2024

[SNMP è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece Gestione remota Windows, ovvero l'implementazione Microsoft di WS-Man.

La struttura smiVALUE WinSNMP descrive il valore associato a un nome di variabile in una voce di associazione di variabili.

Il membro della sintassi della struttura smiVALUE contiene un tipo di dati WinSNMP che indica il tipo di dati nel membro del valore . Il membro valore della struttura è l'unione di tutti i possibili tipi di dati WinSNMP.

Sintassi

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

Members

syntax

Tipo: smiUINT32

Specifica un intero lungo senza segno che indica il tipo di dati della sintassi del membro del valore . Questo membro può essere solo uno dei tipi elencati nella tabella seguente. Per altre informazioni, vedere Tipi di dati WinSNMP e RFC 1902, "Struttura delle informazioni di gestione per la versione 2 del protocollo di gestione di rete semplice (SNMPv2)."

Tipo di dati della sintassi	Significato
SNMP_SYNTAX_INT	Indica una variabile integer con segno a 32 bit.
SNMP_SYNTAX_OCTETS	Indica una variabile di stringa ottet che è dati binari o testuali.
SNMP_SYNTAX_NULL	Indica un valore NULL .
SNMP_SYNTAX_OID	Indica una variabile di identificatore di oggetto che è un nome assegnato con un massimo di 128 sottoidentifier.
SNMP_SYNTAX_INT32	Indica una variabile integer con segno a 32 bit.
SNMP_SYNTAX_IPADDR	Indica una variabile di indirizzo Internet a 32 bit.
SNMP_SYNTAX_CNTR32	Indica una variabile contatore che aumenta fino a raggiungere un valore massimo di (2^32) - 1.
SNMP_SYNTAX_GAUGE32	Indica una variabile del misuratore che è un intero non negativo che può aumentare o diminuire, ma non superare mai un valore massimo.
SNMP_SYNTAX_TIMETICKS	Indica una variabile contatore che misura il tempo in centesimi di secondo, fino a raggiungere un valore massimo pari a (2^32) - 1. È un intero non negativo relativo a un evento timer specifico.
SNMP_SYNTAX_OPAQUE	Questo tipo fornisce compatibilità con le versioni precedenti e non deve essere usato per i nuovi tipi di oggetto. Supporta la funzionalità per passare la sintassi astratta arbitraria Notation One (ASN.1).
SNMP_SYNTAX_CNTR64	Indica una variabile di contatore che aumenta fino a raggiungere un valore massimo di (2^64) - 1.
SNMP_SYNTAX_UINT32	Indica una variabile integer senza segno a 32 bit.
SNMP_SYNTAX_NOSUCHOBJECT	Indica che l'agente non supporta il tipo di oggetto corrispondente alla variabile.
SNMP_SYNTAX_NOSUCHINSTANCE	Indica che l'istanza dell'oggetto non esiste per l'operazione.
SNMP_SYNTAX_ENDOFMIBVIEW	Indica che l'applicazione WinSNMP sta tentando di fare riferimento a un identificatore di oggetto che supera la fine dell'albero MIB supportato dall'agente.

Gli ultimi tre tipi di sintassi descrivono le condizioni di eccezione nel framework SNMP versione 2C (SNMPv2C).

value

Specifica l'unione di tutti i tipi di dati della sintassi WinSNMP possibili, inclusi i tipi di descrittore smiOID o smiOCTETS .

sNumber

Tipo: smiINT Specifica un valore intero lungo firmato.

uNumber

Tipo: smiUINT32 Specifica un valore intero long senza segno a 32 bit.

hNumber

Tipo: smiCNTR64 Specifica un valore intero senza segno a 64 bit

string

Tipo: smiOCTETS Specifica una stringa.

oid

Tipo: smiOID Specifica un identificatore di oggetto (OID).

empty

Tipo: smiBYTE Specifica un membro vuoto.

value.sNumber

value.uNumber

value.hNumber

value.string

value.oid

value.empty

Commenti

Un'applicazione WinSNMP deve controllare il membro della sintassi di una struttura smiVALUE per dereferenziare correttamente il membro del valore . Il membro del valore può contenere un valore scalare semplice o un valore non scalare come un smiOCTETS o una struttura descrittore smiOID .

Se il membro della sintassi indica che il membro del valore è una struttura smiOCTETS o un descrittore smiOID , l'applicazione WinSNMP deve determinare se liberare le risorse allocate per la struttura. L'implementazione di Microsoft WinSNMP alloca e dealloca la memoria per tutte le strutture smiOCTETS di output e smiOID . L'applicazione deve chiamare la funzione SnmpFreeDescriptor per liberare la memoria per il membro ptr di queste strutture.

Poiché l'applicazione WinSNMP alloca la memoria per i descrittori di input con lunghezze variabili, deve liberare tale memoria. Per altre informazioni, vedere Concetti di Gestione dati WinSNMP.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	winsnmp.h