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

Статья
08/27/2023

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

Функция WinSNMP SnmpOidCompare лексикографически сравнивает два идентификатора объекта SNMP до длины, заданной параметром maxlen .

Синтаксис

SNMPAPI_STATUS SNMPAPI_CALL SnmpOidCompare(
  [in]  smiLPCOID xOID,
  [in]  smiLPCOID yOID,
  [in]  smiUINT32 maxlen,
  [out] smiLPINT  result
);

Параметры

[in] xOID

Указатель на первый сравниваемый идентификатор объекта smiOID . Длина идентификатора объекта может быть равна нулю.

[in] yOID

Указатель на второй идентификатор объекта smiOID для сравнения. Длина идентификатора объекта может быть равна нулю.

[in] maxlen

Если значение не равно нулю, указывает количество сравниваемых подидентификаторов. Этот параметр должен быть меньше MAXOBJIDSIZE: 128 подидентификаторов, максимальное число компонентов в идентификаторе объекта. Дополнительные сведения см. в следующем разделе Примечаний.

[out] result

Указатель на целочисленную переменную для получения результата сравнения. Переменная может получить один из следующих результатов.

Результат	Значение
Больше 0	xOID больше yOID
Равно 0	xOID равно yOID
Меньше 0	xOID меньше yOID

Дополнительные условия сравнения см. в следующем разделе о примечаниях.

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

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

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

Код возврата	Описание
SNMPAPI_NOT_INITIALIZED	Не удалось выполнить функцию SnmpStartup .
SNMPAPI_ALLOC_ERROR	Ошибка при выделении памяти.
SNMPAPI_OID_INVALID	Один или оба параметра xOID и yOID недопустимы.
SNMPAPI_SIZE_INVALID	Недопустимый параметр maxlen . Размер параметра больше MAXOBJIDSIZE.
SNMPAPI_OTHER_ERROR	Произошла неизвестная или неопределенная ошибка.

Если параметр maxlen не равен нулю и не больше MAXOBJIDSIZE, значение maxlen задает верхний предел для сравниваемого числа подидентификаторов. Максимальное число подидентификаторов, которое функция SnmpOidCompare сравнивает по умолчанию с наименьшим числом — параметром maxlen или элементом len одной из структур smiOID , на которые указывают параметры xOID и yOID .

Если параметр maxlen равен нулю, максимальное число подидентификаторов, сравниваемых функцией SnmpOidCompare , по умолчанию соответствует числу меньшего числа элементов len двух структур smioid .

Значение параметра result указывает, что xOID равно yOID, если две структуры smiOID лексикографически равны и происходит одно из следующих действий:

SnmpOidCompare сравнивает максимальное число подидентификаторов.
SnmpOidCompare сравнивает максимальное число подидентификаторов, а члены len обеих структур smiOID равны, но меньше, чем параметр maxlen .

Требования

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

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

Функции WinSNMP

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

smiOID