Estructura smiVALUE (winsnmp.h)

Artículo
03/04/2024

[SNMP está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use la administración remota de Windows, que es la implementación de Microsoft de WS-Man.]

La estructura smiVALUE de WinSNMP describe el valor asociado a un nombre de variable en una entrada de enlace de variable.

El miembro de sintaxis de la estructura smiVALUE contiene un tipo de datos WinSNMP que indica el tipo de datos en el miembro de valor . El miembro de valor de la estructura es la unión de todos los tipos de datos winSNMP posibles.

Sintaxis

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

Miembros

syntax

Tipo: smiUINT32

Especifica un entero largo sin signo que indica el tipo de datos de sintaxis del miembro de valor . Este miembro solo puede ser uno de los tipos enumerados en la tabla siguiente. Para obtener más información, vea Tipos de datos WinSNMP y RFC 1902, "Estructura de información de administración para la versión 2 del Protocolo de administración de red simple (SNMPv2)."

Tipo de datos de sintaxis	Significado
SNMP_SYNTAX_INT	Indica una variable de entero con signo de 32 bits.
SNMP_SYNTAX_OCTETS	Indica una variable de cadena de octeto que es datos binarios o textuales.
SNMP_SYNTAX_NULL	Indica un valor NULL .
SNMP_SYNTAX_OID	Indica una variable de identificador de objeto que es un nombre asignado con un máximo de 128 subidentificadores.
SNMP_SYNTAX_INT32	Indica una variable de entero con signo de 32 bits.
SNMP_SYNTAX_IPADDR	Indica una variable de dirección de Internet de 32 bits.
SNMP_SYNTAX_CNTR32	Indica una variable de contador que aumenta hasta que alcanza un valor máximo de (2^32) – 1.
SNMP_SYNTAX_GAUGE32	Indica una variable de medidor que es un entero no negativo que puede aumentar o disminuir, pero nunca superar un valor máximo.
SNMP_SYNTAX_TIMETICKS	Indica una variable de contador que mide el tiempo en centésimas de segundo, hasta que alcanza un valor máximo de (2^32) – 1. Es un entero no negativo relativo a un evento de temporizador específico.
SNMP_SYNTAX_OPAQUE	Este tipo proporciona compatibilidad con versiones anteriores y no se debe usar para los nuevos tipos de objeto. Admite la capacidad de pasar sintaxis abstracta arbitraria notación de sintaxis one (ASN.1).
SNMP_SYNTAX_CNTR64	Indica una variable de contador que aumenta hasta que alcanza un valor máximo de (2^64) – 1.
SNMP_SYNTAX_UINT32	Indica una variable de entero de 32 bits sin signo.
SNMP_SYNTAX_NOSUCHOBJECT	Indica que el agente no admite el tipo de objeto que corresponde a la variable .
SNMP_SYNTAX_NOSUCHINSTANCE	Indica que la instancia de objeto no existe para la operación.
SNMP_SYNTAX_ENDOFMIBVIEW	Indica que la aplicación WinSNMP está intentando hacer referencia a un identificador de objeto que está más allá del final del árbol MIB que admite el agente.

Los tres últimos tipos de sintaxis describen las condiciones de excepción en el marco snmp versión 2C (SNMPv2C).

value

Especifica la unión de todos los tipos de datos de sintaxis winSNMP posibles, incluidos los tipos de descriptor smiOID o smiOCTETS .

sNumber

Tipo: smiINT Especifica un valor entero largo con signo.

uNumber

Tipo: smiUINT32 Especifica un valor entero largo de 32 bits sin signo.

hNumber

Tipo: smiCNTR64 Especifica un valor entero de 64 bits sin signo.

string

Tipo: smiOCTETS Especifica una cadena.

oid

Tipo: smiOID Especifica un identificador de objeto (OID).

empty

Tipo: smiBYTE Especifica un miembro vacío.

value.sNumber

value.uNumber

value.hNumber

value.string

value.oid

value.empty

Comentarios

Una aplicación WinSNMP debe comprobar el miembro de sintaxis de una estructura smiVALUE para desreferenciar correctamente el miembro de valor . El miembro value puede contener un valor escalar simple o un valor no escalar, como un smiOCTETS o una estructura de descriptores smiOID .

Si el miembro de sintaxis indica que el miembro de valor es un smiOCTETS o una estructura de descriptores smiOID , la aplicación WinSNMP debe determinar si liberar los recursos asignados para la estructura. La implementación de Microsoft WinSNMP asigna y desasigna la memoria para todas las estructuras smiOCTETS y smiOID de salida. La aplicación debe llamar a la función SnmpFreeDescriptor para liberar la memoria del miembro ptr de estas estructuras.

Dado que la aplicación WinSNMP asigna memoria para descriptores de entrada con longitudes variables, debe liberar esa memoria. Para obtener más información, consulte Conceptos de Administración de datos winSNMP.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	winsnmp.h