Функция SnmpDuplicateVbl (winsnmp.h)

  • Статья

[SNMP доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте удаленное управление Windows, которое является реализацией WS-Man майкрософт.]

Функция WinSNMP SnmpDuplicateVbl копирует список привязок переменных для указанного сеанса WinSNMP. Эта функция возвращает дескриптор в скопированный список привязок переменных и выделяет для него необходимую память.

Синтаксис

HSNMP_VBL SNMPAPI_CALL SnmpDuplicateVbl(
  [in] HSNMP_SESSION session,
  [in] HSNMP_VBL     vbl
);

Параметры

[in] session

Обработка в сеансе WinSNMP.

[in] vbl

Обработка списка привязок переменных для копирования. Список привязок исходных переменных может быть пустым.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение является дескриптором для нового списка привязок переменных.

Если функция завершается сбоем, возвращаемое значение SNMPAPI_FAILURE. Чтобы получить расширенные сведения об ошибке, вызовите SnmpGetLastError. Функция SnmpGetLastError может возвращать одну из следующих ошибок.

Код возврата Описание
SNMPAPI_NOT_INITIALIZED
 Не удалось выполнить функцию SnmpStartup .
SNMPAPI_ALLOC_ERROR
 Ошибка при выделении памяти.
SNMPAPI_SESSION_INVALID
 Недопустимый дескриптор сеанса.
SNMPAPI_VBL_INVALID
 Недопустимый параметр vbl .
SNMPAPI_OTHER_ERROR
 Произошла неизвестная или неопределенная ошибка.

Комментарии

Функция SnmpDuplicateVbl создает новый список привязок переменных для указанного сеанса WinSNMP. Эта функция инициализирует новый список копией данных в списке привязок исходных переменных.

Дескриптор, возвращающий функцию SnmpDuplicateVbl , уникален среди дескрипторов списка привязок переменных, которые активны в приложении WinSNMP.

Приложение WinSNMP должно освободить ресурсы, связанные с каждым списком привязок переменных. Для этого необходимо сопоставить каждый вызов с функциями SnmpCreateVbl и SnmpDuplicateVbl с соответствующим вызовом функции SnmpFreeVbl . Чтобы избежать утечки памяти, приложение WinSNMP должно вызвать SnmpFreeVbl , прежде чем повторно использовать дескриптор для списка привязок переменных при последующем вызове SnmpCreateVbl или SnmpDuplicateVbl. Дополнительные сведения см. в разделе Основные понятия Управление данными WinSNMP.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winsnmp.h
Библиотека Wsnmp32.lib
DLL Wsnmp32.dll

См. также раздел

SnmpCreateVbl

SnmpFreeVbl

Функции WinSNMP

Общие сведения об API WinSNMP