Estrutura smiVALUE (winsnmp.h)

Artigo
08/27/2023

[O SNMP está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use o Gerenciamento Remoto do Windows, que é a implementação da Microsoft do WS-Man.]

A estrutura smiVALUE do WinSNMP descreve o valor associado a um nome de variável em uma entrada de associação de variável.

O membro de sintaxe da estrutura smiVALUE contém um tipo de dados WinSNMP que indica o tipo de dados no membro de valor . O membro de valor da estrutura é a união de todos os tipos de dados WinSNMP possíveis.

Sintaxe

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

Membros

syntax

Tipo: smiUINT32

Especifica um inteiro longo sem sinal que indica o tipo de dados de sintaxe do membro do valor . Esse membro pode ser apenas um dos tipos listados na tabela a seguir. Para obter mais informações, consulte Tipos de dados WinSNMP e RFC 1902, "Estrutura de informações de gerenciamento para a versão 2 do Protocolo de Gerenciamento de Rede Simples (SNMPv2)."

Tipo de dados de sintaxe	Significado
SNMP_SYNTAX_INT	Indica uma variável de inteiro com sinal de 32 bits.
SNMP_SYNTAX_OCTETS	Indica uma variável de cadeia de caracteres de octeto que são dados binários ou textuais.
SNMP_SYNTAX_NULL	Indica um valor NULL .
SNMP_SYNTAX_OID	Indica uma variável de identificador de objeto que é um nome atribuído com um máximo de 128 subidentifiers.
SNMP_SYNTAX_INT32	Indica uma variável de inteiro com sinal de 32 bits.
SNMP_SYNTAX_IPADDR	Indica uma variável de endereço da Internet de 32 bits.
SNMP_SYNTAX_CNTR32	Indica uma variável de contador que aumenta até atingir um valor máximo de (2^32) – 1.
SNMP_SYNTAX_GAUGE32	Indica uma variável de medidor que é um inteiro não negativo que pode aumentar ou diminuir, mas nunca exceder um valor máximo.
SNMP_SYNTAX_TIMETICKS	Indica uma variável de contador que mede o tempo em centésimos de segundo, até atingir um valor máximo de (2^32) – 1. É um inteiro não negativo relativo a um evento de temporizador específico.
SNMP_SYNTAX_OPAQUE	Esse tipo fornece compatibilidade com versões anteriores e não deve ser usado para novos tipos de objeto. Ele dá suporte à capacidade de passar a sintaxe arbitrária de Notação de Sintaxe Abstrata Um (ASN.1).
SNMP_SYNTAX_CNTR64	Indica uma variável de contador que aumenta até atingir um valor máximo de (2^64) – 1.
SNMP_SYNTAX_UINT32	Indica uma variável de inteiro sem sinal de 32 bits.
SNMP_SYNTAX_NOSUCHOBJECT	Indica que o agente não dá suporte ao tipo de objeto que corresponde à variável.
SNMP_SYNTAX_NOSUCHINSTANCE	Indica que a instância do objeto não existe para a operação.
SNMP_SYNTAX_ENDOFMIBVIEW	Indica que o aplicativo WinSNMP está tentando fazer referência a um identificador de objeto que está além do final da árvore MIB compatível com o agente.

Os últimos três tipos de sintaxe descrevem as condições de exceção na estrutura SNMPv2C (versão 2C) do SNMP.

value

Especifica a união de todos os tipos de dados de sintaxe WinSNMP possíveis, incluindo os tipos de descritor smiOID ou smiOCTETS .

sNumber

Tipo: smiINT Especifica um valor inteiro longo assinado.

uNumber

Tipo: smiUINT32 Especifica um valor inteiro longo sem sinal de 32 bits.

hNumber

Tipo: smiCNTR64 Especifica um valor inteiro sem sinal de 64 bits

string

Tipo: smiOCTETS Especifica uma cadeia de caracteres.

oid

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

vazio

Tipo: smiBYTE Especifica um membro vazio.

value.sNumber

value.uNumber

value.hNumber

value.string

value.oid

value.empty

Comentários

Um aplicativo WinSNMP deve marcar o membro de sintaxe de uma estrutura smiVALUE para desreferenciar corretamente o membro do valor. O membro de valor pode conter um valor escalar simples ou um valor não escalar, como um smiOCTETS ou uma estrutura de descritor smiOID .

Se o membro de sintaxe indicar que o membro do valor é um smiOCTETS ou uma estrutura de descritor smiOID , o aplicativo WinSNMP deve determinar se os recursos alocados para a estrutura devem ser liberados. A implementação do Microsoft WinSNMP aloca e desaloca a memória para todas as estruturas smiOCTETS e smiOID de saída. O aplicativo deve chamar a função SnmpFreeDescriptor para liberar a memória para o membro ptr dessas estruturas.

Como o aplicativo WinSNMP aloca memória para descritores de entrada com comprimentos variáveis, ele deve liberar essa memória. Para obter mais informações, consulte Conceitos de Gerenciamento de Dados do WinSNMP.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	winsnmp.h