Función SnmpOidToStr (winsnmp.h)
[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 administración remota de Windows, que es la implementación de Microsoft de WS-Man.]
La función SnmpOidToStr de WinSNMP convierte la representación binaria interna de un identificador de objeto SNMP en su formato de cadena numérica de puntos, por ejemplo, en "1.2.3.4.5.6".
Sintaxis
SNMPAPI_STATUS SNMPAPI_CALL SnmpOidToStr(
[in] smiLPCOID srcOID,
[in] smiUINT32 size,
[out] LPSTR string
);
Parámetros
[in] srcOID
Puntero a una estructura smiOID con un identificador de objeto que se va a convertir.
[in] size
Especifica el tamaño, en bytes, del búfer indicado por el parámetro de cadena . Para obtener más información, vea la sección Comentarios que se muestra más adelante.
[out] string
Puntero a un búfer para recibir el identificador de objeto de cadena convertido que especifica la entidad de administración snmp.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es la longitud, en bytes, de la cadena que la aplicación WinSNMP escribe en el parámetro string . El valor devuelto incluye un byte de terminación NULL. Este valor puede ser menor o igual que el valor del parámetro size , pero puede que no sea mayor.
Si se produce un error en la función, el valor devuelto se SNMPAPI_FAILURE. Para obtener información de error extendida, llame a SnmpGetLastError especificando un valor NULL en su parámetro de sesión . La función SnmpGetLastError puede devolver uno de los siguientes errores.
| Código devuelto | Descripción |
|---|---|
|
La función SnmpStartup no se completó correctamente. |
|
Error durante la asignación de memoria. |
|
El parámetro size no es válido. Este parámetro no puede ser igual a cero; debe indicar el tamaño del búfer al que apunta el parámetro de cadena . |
|
El parámetro srcOID no es válido. Para obtener más información, vea la siguiente sección Comentarios. |
|
La longitud del búfer de salida no es suficiente. |
|
Se produjo un error desconocido o no definido. |
Comentarios
Se recomienda especificar una aplicación WinSNMP, con el parámetro size , un búfer de cadena de longitud MAXOBJIDSTRSIZE (1408 bytes). Esto garantiza que el búfer de salida sea lo suficientemente grande como para contener la cadena convertida. Dado que la cadena convertida suele ser menor que MAXOBJIDSTRSIZE, la aplicación WinSNMP puede copiar la cadena convertida en un búfer más pequeño. Después, la aplicación puede reutilizar o liberar la memoria que asignó para el búfer inicial. Para obtener más información, consulte Conceptos de winSNMP Administración de datos.
Requisitos
| 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 | winsnmp.h |
| Library | Wsnmp32.lib |
| Archivo DLL | Wsnmp32.dll |