Поделиться через

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

  • Статья

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

Функция SnmpOidCopy WinSNMP копирует идентификатор объекта SNMP, выделяя необходимую память для копии.

Синтаксис

SNMPAPI_STATUS SNMPAPI_CALL SnmpOidCopy(
  [in]  smiLPCOID srcOID,
  [out] smiLPOID  dstOID
);

Параметры

[in] srcOID

Указатель на структуру smiOID для копирования.

[out] dstOID

Указатель на структуру smiOID для получения копии идентификатора объекта, указанного параметром srcOID .

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

Если функция выполняется успешно, возвращаемое значение — это количество подидентификаторов в скопированном идентификаторе объекта. Это число также является значением элемента len структуры smiOID, на которую указывает параметр dstOID .

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

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

Комментарии

На входных данных функция SnmpOidCopy игнорирует члены структуры smiOID , на которую указывает параметр dstOID . Реализация Microsoft WinSNMP перезаписывает члены smiOID при успешном завершении функции.

Приложение WinSNMP должно вызвать функцию SnmpFreeDescriptor , чтобы реализовать освобождение ресурсов, выделенных для элемента ptr структуры smiOID , на которую указывает параметр dstOID . Дополнительные сведения см. в разделах Основные понятия Управление данными WinSNMP и Освобождение дескрипторов WinSNMP.

Требования

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

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

SnmpFreeDescriptor

Функции WinSNMP

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

smiOID