Дескрипторы WinSNMP

В среде программирования WinSNMP дескриптор является одной из следующих двух структур:

  • Структура smiOCTETS , описывающая переменную строки октета.
  • Структура smiOID , описывающая переменную идентификатора объекта SNMP.

Дескриптор WinSNMP — это структура, которая содержит два элемента: элемент длины, len и элемент указателя ptr. Элемент ptr указывает на интересующую строку октета или идентификатор объекта. Элемент ptr может быть типом данных smiLPBYTE или smiLPUINT32 .

Дескриптор smiOCTETS или дескриптор smiOID может быть членом значения структуры smiVALUE . Структура smiVALUE описывает значение, связанное с именем переменной в записи привязки переменной.

Реализация Microsoft WinSNMP выделяет и освобождает память для всех выходных структур smiOCTETS и smiOID . Поэтому приложение должно вызывать функцию SnmpFreeDescriptor , чтобы освободить память для элемента ptr этих структур.

Для строковых элементов в дескрипторов не требуется завершающий байт NULL . Дополнительные сведения об управлении памятью, выделенной для дескрипторов, см. в разделе Выделение объектов памяти WinSNMP.