Поделиться через


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

[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

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

SnmpDuplicateVbl

SnmpFreeVbl

Функции WinSNMP

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

smiOID

smiVALUE