Заголовок winsnmp.h

Этот заголовок используется простым протоколом управления сетью. Дополнительные сведения см. в разделе:

• Протокол SNMP

Winsnmp.h содержит следующие программные интерфейсы:

Функции

SnmpCancelMsg Приложение WinSNMP вызывает функцию SnmpCancelMsg, чтобы запросить, чтобы реализация Microsoft WinSNMP отменила попытки повторной передачи и уведомления об истечении времени ожидания для сообщения запроса SNMP.
SnmpCleanup Функция SnmpCleanup информирует реализацию Microsoft WinSNMP о том, что вызывающее приложение WinSNMP больше не требует служб реализации.
SnmpCleanupEx Функция SnmpCleanupEx выполняет очистку, если в приложении Windows SNMP (WinSNMP) отсутствуют невыполненные успешные вызовы SnmpStartup или SnmpStartupEx.
SnmpClose Функция SnmpClose позволяет реализации Microsoft WinSNMP освободить память, ресурсы и структуры данных, связанные с сеансом WinSNMP.
SnmpContextToStr Функция WinSNMP SnmpContextToStr возвращает строку, определяющую контекст SNMP, который представляет собой набор ресурсов управляемого объекта. Функция возвращает строку в структуре smiOCTETS.
SnmpCountVbl Приложение WinSNMP вызывает функцию SnmpCountVbl WinSNMP для перечисления записей привязки переменных в указанном списке привязок переменных.
SnmpCreatePdu Функция SnmpCreatePdu WinSNMP создает и инициализирует единицу данных протокола SNMP (PDU).
SnmpCreateSession Функция SnmpCreateSession запрашивает реализацию Microsoft WinSNMP, чтобы открыть сеанс для приложения WinSNMP.
SnmpCreateVbl Функция SnmpCreateVbl WinSNMP создает новый список привязок переменных для вызывающего приложения WinSNMP.
SnmpDecodeMsg Функция SnmpDecodeMsg WinSNMP декодирует закодированное сообщение SNMP в его компоненты. Эта функция выполняет действие, противоположное функции SnmpEncodeMsg WinSNMP.
SnmpDeleteVb Функция WinSNMP SnmpDeleteVb удаляет запись привязки переменной из списка привязок переменных.
SnmpDuplicatePdu Функция SnmpDuplicatePdu WinSNMP дублирует единицу данных протокола SNMP, определяемую параметром PDU, выделяя необходимую память для повторяющегося PDU.
SnmpDuplicateVbl Функция WinSNMP SnmpDuplicateVbl копирует список привязок переменных для указанного сеанса WinSNMP. Эта функция возвращает дескриптор скопированного списка привязок переменных и выделяет для него необходимую память.
SnmpEncodeMsg Реализация Microsoft WinSNMP использует параметры, переданные в функции SnmpEncodeMsg WinSNMP, для кодирования сообщения SNMP.
SnmpEntityToStr Функция SnmpEntityToStr WinSNMP возвращает строку, идентифицирующая сущность управления SNMP.
SnmpFreeContext Функция SnmpFreeContext WinSNMP освобождает ресурсы, связанные с контекстом SNMP, который представляет собой набор ресурсов управляемого объекта.
SnmpFreeDescriptor Приложение WinSNMP использует функцию SnmpFreeDescriptor для информирования реализации Microsoft WinSNMP о том, что ему больше не требуется доступ к объекту дескриптора.
SnmpFreeEntity Функция SnmpFreeEntity WinSNMP освобождает ресурсы, связанные с сущностью управления SNMP.
SnmpFreePdu Функция SnmpFreePdu WinSNMP освобождает ресурсы, связанные с единицей данных протокола SNMP (PDU), созданной функцией SnmpCreatePdu или SnmpDuplicatePdu.
SnmpFreeVbl Функция SnmpFreeVbl WinSNMP освобождает ресурсы, связанные со списком привязок переменных. Это ресурсы, выделенные ранее вызовом функции SnmpCreateVbl или SnmpDuplicateVbl в приложении WinSNMP.
SnmpGetLastError Функция SnmpGetLastError WinSNMP возвращает значение кода последней ошибки вызывающего приложения. Значение указывает причину сбоя последнего вызова функции, выполненного приложением WinSNMP.
SnmpGetPduData Функция SnmpGetPduData WinSNMP возвращает выбранные поля данных из указанной единицы данных протокола SNMP (PDU).
SnmpGetRetransmitMode Функция SnmpGetRetransmitMode WinSNMP возвращает текущее значение режима повторной передачи в приложение WinSNMP.
SnmpGetRetry Функция SnmpGetRetry WinSNMP возвращает значение счетчика повторных попыток в единицах для повторной передачи запросов сообщений SNMP. Число повторных попыток применяется к вызовам, которые приложение WinSNMP выполняет к функции SnmpSendMsg для указанной сущности управления.
SnmpGetTimeout Функция SnmpGetTimeout WinSNMP возвращает значение времени ожидания в сотых секундах для передачи запросов сообщений SNMP.
SnmpGetTranslateMode Функция SnmpGetTranslateMode WinSNMP возвращает текущее значение режима преобразования сущности и контекста в приложение WinSNMP.
SnmpGetVb Приложение WinSNMP вызывает функцию SnmpGetVb для получения сведений из списка привязок переменных. Эта функция WinSNMP получает имя переменной и связанное с ней значение из записи привязки переменной, указанной параметром index.
SnmpGetVendorInfo Приложение WinSNMP вызывает функцию SnmpGetVendorInfo для получения сведений о реализации Microsoft WinSNMP.
SnmpListen Функция SnmpListen WinSNMP регистрирует приложение WinSNMP в качестве агента SNMP.
SnmpOidCompare Функция WinSNMP SnmpOidCompare лексикографически сравнивает два идентификатора объектов SNMP до длины, указанной параметром maxlen.
SnmpOidCopy Функция SnmpOidCopy WinSNMP копирует идентификатор объекта SNMP, выделяя необходимую память для копии.
SnmpOidToStr Функция SnmpOidToStr WinSNMP преобразует внутреннее двоичное представление идентификатора объекта SNMP в формат его пунктирной числовой строки, например в "1.2.3.4.5.6".
SnmpOpen Функция SnmpOpen запрашивает реализацию Microsoft WinSNMP, чтобы открыть сеанс для приложения WinSNMP.
SnmpRecvMsg Функция SnmpRecvMsg WinSNMP извлекает результаты завершенного асинхронного запроса, отправленного вызовом функции SnmpSendMsg, в виде SNMP-сообщения.
SnmpRegister Функция SnmpRegister WinSNMP регистрирует или отменяет регистрацию приложения WinSNMP для получения отловок и уведомлений. Приложение может регистрировать и получать ловушки и уведомления, а также отменять регистрацию и отключать ловушки и уведомления.
SnmpSendMsg Приложение WinSNMP вызывает функцию SnmpSendMsg, чтобы запросить, чтобы реализация Microsoft WinSNMP передала единицу данных протокола SNMP (PDU) в виде SNMP-сообщения.
SnmpSetPduData Функция SnmpSetPduData WinSNMP обновляет выбранные поля данных в указанной единице данных протокола SNMP (PDU).
SnmpSetPort Приложение WinSNMP вызывает функцию SnmpSetPort, чтобы изменить порт, назначенный целевой сущности. Функция SnmpSetPort является элементом API WinSNMP версии 2.0.
SnmpSetRetransmitMode Функция SnmpSetRetransmitMode WinSNMP позволяет приложению WinSNMP задать режим повторной передачи.
SnmpSetRetry Функция SnmpSetRetry WinSNMP позволяет приложению WinSNMP изменять значение счетчика повторных попыток для повторной передачи запросов сообщений SNMP.
SnmpSetTimeout Функция WinSNMP SnmpSetTimeout позволяет приложению WinSNMP изменять значение времени ожидания для передачи запросов сообщений SNMP.
SnmpSetTranslateMode Функция WinSNMP SnmpSetTranslateMode позволяет приложению WinSNMP изменять режим преобразования сущностей и контекста. Режим преобразования сущности и контекста влияет на интерпретацию и возврат входных и выходных параметров строки WinSNMP.
SnmpSetVb Функция WinSNMP SnmpSetVb изменяет записи привязки переменных в списке привязок переменных. Эта функция также добавляет новые записи привязки переменных к существующему списку привязок переменных.
SnmpStartup Функция SnmpStartup уведомляет реализацию Microsoft WinSNMP о том, что приложению WinSNMP требуются службы реализации.
SnmpStartupEx Функция SnmpStartupEx уведомляет реализацию Microsoft WinSNMP о том, что приложению WinSNMP требуются службы реализации.
SnmpStrToContext Функция SnmpStrToContext WinSNMP возвращает дескриптор для сведений контекста SNMP, относящихся к реализации Microsoft WinSNMP.
SnmpStrToEntity Функция WinSNMP SnmpStrToEntity возвращает дескриптор сведений о сущности управления SNMP, относящееся к реализации Microsoft WinSNMP.
SnmpStrToOid Функция SnmpStrToOid WinSNMP преобразует пунктирный формат строк идентификатора объекта SNMP, например 1.2.3.4.5.6, во внутреннее двоичное представление.

Функции обратного вызова

SNMPAPI_CALLBACK Реализация Microsoft WinSNMP вызывает функцию SNMPAPI_CALLBACK для уведомления сеанса WinSNMP о доступности сообщения SNMP или асинхронного события.

Структуры

smiCNTR64 Структура WinSNMP smiCNTR64 содержит 64-разрядное целое число без знака. Структура представляет 64-разрядный счетчик.
smiOCTETS Структура winSNMP smiOCTETS передает строки контекста нескольким функциям WinSNMP. Структура также описывает и получает закодированные SNMP-сообщения.
smiOID Структура smiOID WinSNMP передает идентификаторы объектов нескольким функциям WinSNMP. Структура также получает имя переменной записи привязки переменной в вызове функции SnmpGetVb.
smiVALUE Структура winSNMP smiVALUE описывает значение, связанное с именем переменной в записи привязки переменной.
smiVENDORINFO Структура smiVENDORINFO содержит сведения о реализации Microsoft WinSNMP.