Функция SnmpUtilIdsToA (snmp.h)
[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 символов, строка усекается и завершается последовательностью из трех точек (...).
Комментарии
Функция SnmpUtilIdsToA может помочь в отладке приложений SNMP.
Обратите внимание, что при вызове SnmpUtilIdsToA применяются следующие ограничения памяти:
- Параметр Ids должен указывать на допустимый блок памяти не менее целых чисел IdLength , иначе вызов функции приводит к исключению нарушения доступа.
- Строка, возвращаемая SnmpUtilIdsToA , находится в памяти, которую выделяет API служебной программы SNMP. Приложение не должно делать никаких предположений о выделении памяти. Данные гарантированно будут действительными, пока вы не вызовете SnmpUtilIdsToA еще раз, поэтому перед повторным вызовом функции необходимо скопировать данные в другое расположение.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | snmp.h |
| Библиотека | Snmpapi.lib |
| DLL | Snmpapi.dll |