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

Статья
08/27/2023

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

Функция SnmpCreateVbl WinSNMP создает новый список привязок переменных для вызывающего приложения WinSNMP. Если параметры name и value не равны NULL, SnmpCreateVbl использует их значения для создания первой записи привязки переменных для нового списка привязок переменных. Функция SnmpCreateVbl возвращает дескриптор в новый список привязок переменных и выделяет для него необходимую память.

Синтаксис

HSNMP_VBL SNMPAPI_CALL SnmpCreateVbl(
  [in] HSNMP_SESSION session,
  [in] smiLPCOID     name,
  [in] smiLPCVALUE   value
);

Параметры

[in] session

Дескриптор сеанса WinSNMP.

[in] name

Указатель на структуру smiOID , содержащую имя переменной для первой записи привязки переменной. Этот параметр может принимать значение NULL. Дополнительные сведения см. в следующем разделе Примечаний.

[in] value

Указатель на структуру smiVALUE , содержащую значение, которое необходимо связать с переменной в первой записи привязки переменной. Этот параметр может принимать значение NULL. Дополнительные сведения см. в следующем разделе Примечаний.

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

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

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

Код возврата	Описание
SNMPAPI_NOT_INITIALIZED	Функция SnmpStartup не была успешно завершена.
SNMPAPI_ALLOC_ERROR	Произошла ошибка при выделении памяти.
SNMPAPI_SESSION_INVALID	Недопустимый дескриптор сеанса.
SNMPAPI_OID_INVALID	Параметр name ссылается на недопустимую структуру smiOID .
SNMPAPI_SYNTAX_INVALID	Недопустимый синтаксический элемент структуры, на который указывает параметр value .
SNMPAPI_OTHER_ERROR	Произошла неизвестная или неопределенная ошибка.

Функция SnmpCreateVbl использует значения параметров name и value для создания и инициализации первой записи привязки переменной нового списка привязок переменных. Если параметр name имеет значение NULL, реализация Microsoft WinSNMP игнорирует параметр value и создает пустой список привязок переменных.

Если параметр name не равен NULL, а параметру value присвоено значение NULL, реализация создает и инициализирует первую запись привязки переменной в списке привязок переменных. Он инициализирует синтаксический элемент структуры, на который указывает параметр value , со значением SNMP_SYNTAX_NULL.

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

Требования


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