Функция SnmpUtilIdsToA (snmp.h)

Статья
08/26/2023

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

Функция SnmpUtilIdsToA преобразует идентификатор объекта (OID) в строку, завершаемую null. Эта функция является элементом API служебной программы SNMP.

Синтаксис

LPSTR SNMP_FUNC_TYPE SnmpUtilIdsToA(
  [in] UINT *Ids,
  [in] UINT IdLength
);

Параметры

[in] Ids

Указатель на массив целых чисел без знака. Массив содержит последовательность чисел, содержащихся в OID. Параметр IdLength указывает длину массива.

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

[in] IdLength

Указывает количество элементов в массиве, на который указывает параметр Ids .

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

Функция возвращает строку, завершающуюся значением NULL, которая содержит строковое представление массива чисел, на который указывает параметр Ids . Строка содержит последовательность чисел, разделенных точками ('.'); например, 1.3.6.1.4.1.311.

Если параметр Ids имеет значение NULL или параметр IdLength указывает ноль, функция возвращает строку null< oid>.

Максимальная длина возвращаемой строки составляет 256 символов. Если длина строки превышает 256 символов, строка усекается и завершается последовательностью из трех точек (...).

Параметр Ids должен указывать на допустимый блок памяти не менее целых чисел IdLength , иначе вызов функции приводит к исключению нарушения доступа.
Строка, возвращаемая SnmpUtilIdsToA , находится в памяти, которую выделяет API служебной программы SNMP. Приложение не должно делать никаких предположений о выделении памяти. Данные гарантированно будут действительными, пока вы не вызовете SnmpUtilIdsToA еще раз, поэтому перед повторным вызовом функции необходимо скопировать данные в другое расположение.

Требования

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

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

Функции SNMP

Обзор протокола SNMP

SnmpUtilOidToA

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