Функция SnmpSetVb (winsnmp.h)
[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 может возвращать одну из следующих ошибок.
Код возврата | Описание |
---|---|
|
Не удалось выполнить функцию SnmpStartup . |
|
Ошибка при выделении памяти. |
|
Недопустимый параметр vbl . |
|
Недопустимый параметр index . |
|
Недопустимый параметр name . |
|
Недопустимый член синтаксиса структуры, на который указывает параметр value . |
|
Произошла неизвестная или неопределенная ошибка. |
Комментарии
Допустимые значения для диапазона параметров индекса от нуля до 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 |