Функция SnmpGetLastError (winsnmp.h)
[SNMP доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте удаленное управление Windows, которое является реализацией WS-Man майкрософт.]
Функция SnmpGetLastError WinSNMP возвращает значение кода последней ошибки вызывающего приложения. Значение указывает причину сбоя последнего вызова функции, выполненного приложением WinSNMP.
Синтаксис
SNMPAPI_STATUS SNMPAPI_CALL SnmpGetLastError(
[in] HSNMP_SESSION session
);
Параметры
[in] session
Обработка в сеансе WinSNMP. Этот параметр также может иметь значение NULL.
В некоторых случаях при сбое вызова функции можно передать значение сеанса NULL в функцию SnmpGetLastError, чтобы получить значение кода последней ошибки. Это справедливо для вызовов функций, не использующих параметр сеанса , и случаев, когда значение параметра сеанса является недопустимым. Эти случаи описаны в разделе Возвращаемые значения на справочной странице функции.
Однопоточное приложение может передать значение сеанса NULLв SnmpGetLastError для получения сведений о последней ошибке для всего приложения.
Дополнительные сведения см. в следующих разделах Примечания и Возвращаемые значения.
Возвращаемое значение
Если параметр сеанса является допустимым дескриптором сеанса WinSNMP, функция SnmpGetLastError возвращает последнюю ошибку WinSNMP, которая произошла для указанного сеанса.
Если параметр сеанса имеет значение NULL , например, если функция SnmpStartup завершается сбоем, SnmpGetLastError возвращает последнюю ошибку WinSNMP.
Комментарии
Чтобы получить код последней ошибки, приложение WinSNMP должно вызывать SnmpGetLastError сразу после сбоя функции. Если другая функция завершается сбоем, она перезаписывает код последней ошибки, заданный последней неудачной функцией. Дополнительные сведения см. в разделе Коды ошибок WinSNMP.
Хотя параметр сеанса поддерживает как многопоточные, так и однопоточные операционные среды Windows, по-прежнему существует потенциал для того, чтобы код последней ошибки из одного потока перезаписывал код последней ошибки из другого потока.
Обратите внимание, что SnmpGetLastError должен иметь возможность возвращать код последней ошибки в приложение WinSNMP при следующих условиях:
- После сбоя функции SnmpStartup
- Перед тем, как функция SnmpCreateSession создает сеансы WinSNMP для экземпляра приложения.
- После того, как функция SnmpClose закрывает все сеансы WinSNMP для экземпляра приложения
- После того, как функция SnmpCleanup отключает приложение WinSNMP от реализации Microsoft WinSNMP
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | winsnmp.h |
| Библиотека | Wsnmp32.lib |
| DLL | Wsnmp32.dll |