Compartilhar via


Estrutura smiOCTETS (winsnmp.h)

[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 smiOCTETS do WinSNMP passa cadeias de caracteres de contexto para várias funções WinSNMP. A estrutura também descreve e recebe mensagens SNMP codificadas.

A estrutura smiOCTETS contém um ponteiro para uma cadeia de caracteres de octeto SNMP de comprimento variável. A estrutura pode ser um membro da estrutura smiVALUE .

Sintaxe

typedef struct {
  smiUINT32 len;
  smiLPBYTE ptr;
} smiOCTETS, *smiLPOCTETS;

Membros

len

Especifica um valor inteiro longo sem sinal que indica o número de bytes na matriz de cadeia de caracteres de octeto apontada pelo membro ptr .

ptr

Ponteiro para uma matriz de bytes que contém a cadeia de caracteres de octeto de interesse. Um byte de terminação NULL não é necessário.

Comentários

A implementação do Microsoft WinSNMP aloca e desaloca a memória para todas as estruturas smiOCTETS de saída. O aplicativo WinSNMP não deve liberar memória que a implementação aloca para o membro ptr de uma estrutura smiOCTETS . Em vez disso, o aplicativo deve chamar a função SnmpFreeDescriptor para liberar a memória.

Como o aplicativo WinSNMP aloca memória para objetos descritores de entrada com comprimentos variáveis, ele deve liberar essa memória. Para obter mais informações, consulte Conceitos de Gerenciamento de Dados 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

Confira também

SnmpContextToStr

SnmpDecodeMsg

SnmpEncodeMsg

SnmpFreeDescriptor

SnmpStrToContext

Visão geral da API do WinSNMP

Estruturas WinSNMP

smiVALUE