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

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

Функция SnmpDuplicatePdu WinSNMP дублирует единицу данных протокола SNMP, определяемую параметром PDU , выделяя необходимую память для повторяющегося PDU.

Синтаксис

HSNMP_PDU SNMPAPI_CALL SnmpDuplicatePdu(
  [in] HSNMP_SESSION session,
  [in] HSNMP_PDU     PDU
);

Параметры

[in] session

Дескриптор сеанса WinSNMP.

[in] PDU

Дескриптор PDU для дублирования. Функция SnmpDuplicatePdu предоставляет уникальный дескриптор для каждого PDU в вызывающем приложении.

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

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

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

Код возврата Описание
SNMPAPI_NOT_INITIALIZED
Функция SnmpStartup не была успешно завершена.
SNMPAPI_ALLOC_ERROR
Произошла ошибка при выделении памяти.
SNMPAPI_SESSION_INVALID
Недопустимый дескриптор сеанса.
SNMPAPI_PDU_INVALID
Недопустимый дескриптор PDU.
SNMPAPI_OTHER_ERROR
Произошла неизвестная или неопределенная ошибка.

Комментарии

Чтобы освободить ресурсы, выделенные функцией SnmpDuplicatePdu для нового PDU, приложение WinSNMP должно вызвать функцию SnmpFreePdu .

Требования

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

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

SnmpFreePdu

SnmpGetPduData

Функции WinSNMP

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