Compartir a través de

Función SnmpUtilIdsToA (snmp.h)

  • Artículo

[SNMP está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use la administración remota de Windows, que es la implementación de Microsoft de WS-Man.]

La función SnmpUtilIdsToA convierte un identificador de objeto (OID) en una cadena terminada en null. Esta función es un elemento de la API de utilidad SNMP.

Sintaxis

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

Parámetros

[in] Ids

Puntero a una matriz de enteros sin signo. La matriz contiene la secuencia de números que contiene el OID. El parámetro IdLength especifica la longitud de la matriz.

Para obtener más información, vea las siguientes secciones Valores devueltos y comentarios.

[in] IdLength

Especifica el número de elementos de la matriz a los que apunta el parámetro Ids .

Valor devuelto

La función devuelve una cadena terminada en null que contiene la representación de cadena de la matriz de números a las que apunta el parámetro Ids . La cadena contiene una secuencia de números separados por puntos ('.'); por ejemplo, 1.3.6.1.4.1.311.

Si el parámetro Ids es null o si el parámetro IdLength especifica cero, la función devuelve la cadena "<oid> null".

La longitud máxima de la cadena devuelta es de 256 caracteres. Si la longitud de la cadena supera los 256 caracteres, la cadena se trunca y finaliza con una secuencia de tres puntos ('...').

Comentarios

La función SnmpUtilIdsToA puede ayudar con la depuración de aplicaciones SNMP.

Tenga en cuenta que se aplican las siguientes restricciones de memoria al llamar a SnmpUtilIdsToA:

  • El parámetro Ids debe apuntar a un bloque de memoria válido de al menos enteros IdLength o la llamada de función produce una excepción de infracción de acceso.
  • La cadena devuelta por SnmpUtilIdsToA reside en la memoria que asigna la API de la utilidad SNMP. La aplicación no debe realizar ninguna suposición sobre la asignación de memoria. Se garantiza que los datos son válidos hasta que se llama a SnmpUtilIdsToA de nuevo, por lo que antes de volver a llamar a la función debe copiar los datos en otra ubicación.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado snmp.h
Library Snmpapi.lib
Archivo DLL Snmpapi.dll

Consulte también

Funciones SNMP

Introducción al Protocolo simple de administración de redes (SNMP)

SnmpUtilOidToA