Descritores WinSNMP
No ambiente de programação WinSNMP, um descritor é uma das duas estruturas a seguir:
- Uma estrutura smiOCTETS que descreve uma variável de cadeia de caracteres de octeto
- Uma estrutura smiOID que descreve uma variável de identificador de objeto SNMP
Um descritor WinSNMP é uma estrutura que tem dois membros: um membro de comprimento, len e um membro de ponteiro, ptr. O membro ptr aponta para a cadeia de caracteres de octeto ou o identificador de objeto de interesse. O membro ptr pode ser o tipo de dados smiLPBYTE ou smiLPUINT32 .
Um descritor smiOCTETS ou um descritor smiOID pode ser o membro de valor de uma estrutura smiVALUE . A estrutura smiVALUE descreve o valor associado a um nome de variável em uma entrada de associação de variável.
A implementação do Microsoft WinSNMP aloca e desaloca a memória para todas as estruturas smiOCTETS e smiOID de saída. Portanto, o aplicativo deve chamar a função SnmpFreeDescriptor para liberar a memória para o membro ptr dessas estruturas.
Os membros de cadeia de caracteres em descritores não exigem um byte de terminação NULL . Para obter informações adicionais sobre como gerenciar a memória alocada para descritores, consulte Alocando objetos de memória WinSNMP.