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

Статья
08/27/2023

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

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

Синтаксис

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetVb(
  [in] HSNMP_VBL   vbl,
  [in] smiUINT32   index,
  [in] smiLPCOID   name,
  [in] smiLPCVALUE value
);

Параметры

[in] vbl

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

[in] index

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

[in] name

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

[in] value

Указатель на структуру smiVALUE . Структура содержит значение, связанное с переменной, указанной параметром name .

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

Если функция выполнена успешно, возвращаемое значение — это позиция обновленной или добавленной записи привязки переменной в списке привязок переменных. Дополнительные сведения см. в следующем разделе Примечаний.

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

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

Допустимые значения для диапазона параметров индекса от нуля до n. Нулевое значение указывает на операцию добавления. Значение n — общее количество записей привязки переменных в списке привязок переменных. Приложение WinSNMP должно вызвать функцию SnmpCountVbl перед вызовом SnmpSetVb , чтобы получить общее количество записей привязки переменных.

Если функция успешно выполняет операцию обновления, возвращаемое значение равно значению параметра индекса . Если функция добавляет запись привязки переменной, возвращается значение n + 1.

Если параметр name не имеет значение NULL, но параметр value имеет значение NULL, реализация Microsoft WinSNMP инициализирует новую запись привязки переменной с элементом значения, равным NULL, а член синтаксиса — SNMP_SYNTAX_.

Если параметр index не равен нулю и параметр name имеет значение NULL, реализация Microsoft WinSNMP обновляет только значение переменной, на которую указывает параметр index .

Требования


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

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

SnmpCountVbl

Функции WinSNMP

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

smiOID

smiVALUE