Funciones SNMP
[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.]
En este tema se describen tres agrupaciones de funciones SNMP y se enumeran las funciones que se incluyen en cada grupo:
- Funciones de API del agente de extensión SNMP
- Funciones de LA API de administración de SNMP
- Funciones de LA API de la utilidad SNMP
Funciones de API del agente de extensión SNMP
Las funciones del agente de extensión SNMP definen la interfaz entre el servicio SNMP y los archivos DLL del agente de extensión SNMP de terceros. En la tabla siguiente se enumeran las funciones que las aplicaciones pueden usar para resolver enlaces de variables especificados por las unidades de datos del protocolo SNMP entrantes (PTU).
Función de API del agente de extensión SNMP | Descripción |
---|---|
SnmpExtensionClose | Solicita que el agente de extensión SNMP desasigne los recursos y finalice las operaciones. |
SnmpExtensionInit | Inicializa el archivo DLL del agente de extensión SNMP. |
SnmpExtensionInitEx | Identifica los subárboles de la base de información de administración adicional (MIB) que admite el agente de extensión SNMP. |
SnmpExtensionMonitor | Proporciona al agente de extensión SNMP información sobre los contadores internos y los parámetros del servicio. |
SnmpExtensionQuery | Resuelve las solicitudes SNMP que contienen variables en uno o varios de los subárboles MIB registrados del agente de extensión SNMP. |
SnmpExtensionQueryEx | Procesa solicitudes SNMP que especifican variables en uno o varios subárboles MIB registrados por agentes de extensión SNMP. |
SnmpExtensionTrap | Recupera información que el servicio requiere para generar capturas para el agente de extensión SNMP. |
Funciones de LA API de administración de SNMP
Las funciones de administración snmp definen la interfaz entre aplicaciones de administrador SNMP de terceros y la biblioteca de vínculos dinámicos (DLL) de la función de administración Mgmtapi.dll. El archivo DLL funciona junto con el servicio de captura snmp (Snmptrap.exe) y puede interactuar con una o varias aplicaciones de administrador SNMP de terceros. En la tabla siguiente se enumeran las funciones de administración que usan las aplicaciones de administrador de terceros para realizar operaciones de administrador snmp.
Función de LA API de administración de SNMP | Descripción |
---|---|
SnmpMgrClose | Cierra los sockets de comunicaciones y las estructuras de datos asociadas a la sesión especificada. |
SnmpMgrCtl | Establece un parámetro operativo asociado a una sesión SNMP. |
SnmpMgrGetTrap | Devuelve datos de captura pendientes que el autor de la llamada no ha recibido si está habilitada la recepción de capturas. |
SnmpMgrGetTrapEx | Devuelve datos de captura pendientes que el autor de la llamada no ha recibido si está habilitada la recepción de capturas. También devuelve la dirección de la fuente de transporte y la trampa comunitaria asociada a la trampa. |
SnmpMgrOidToStr | Convierte una estructura de identificador de objeto interna en su representación de cadena. |
SnmpMgrOpen | Inicializa los sockets de comunicaciones y las estructuras de datos necesarios para establecer la comunicación con el agente SNMP. |
SnmpMgrRequest | Solicita que el agente especificado realice la operación especificada. |
SnmpMgrStrToOid | Convierte el formato de cadena de un identificador de objeto en su estructura de identificador de objeto interna. |
SnmpMgrTrapListen | Registra la capacidad de una aplicación de administrador snmp para recibir capturas SNMP del servicio de capturas SNMP. |
Funciones de LA API de la utilidad SNMP
Las funciones de utilidad SNMP proporcionan funcionalidades útiles durante el desarrollo de aplicaciones SNMP, incluida la simplificación de la manipulación de estructuras de datos SNMP. En la tabla siguiente se enumeran las funciones de la utilidad SNMP.
Función de LA API de la utilidad SNMP | Descripción |
---|---|
SnmpSvcGetUptime | Recupera la hora, en centisegundos, para la que se ha estado ejecutando el servicio SNMP. |
SnmpSvcSetLogLevel | Ajusta el nivel de detalle de la salida de depuración del servicio SNMP y de los agentes de extensión SNMP. |
SnmpSvcSetLogType | Ajusta el destino de la salida de depuración del servicio SNMP y de los agentes de extensión SNMP. |
SnmpUtilAsnAnyCpy | Copia una estructura AsnAny de origen en una estructura AsnAny de destino. |
SnmpUtilAsnAnyFree | Libera la memoria asignada para una estructura AsnAny especificada. |
SnmpUtilDbgPrint | Establece el nivel de información de depuración que se va a recibir desde el servicio SNMP o desde una llamada a SnmpUtilDbgPrint. |
SnmpUtilIdsToA | Convierte un identificador de objeto (OID) en una cadena terminada en null. |
SnmpUtilMemAlloc | Asigna memoria dinámica del montón de procesos. |
SnmpUtilMemFree | Libera el objeto de memoria especificado. |
SnmpUtilMemReAlloc | Cambia el tamaño del objeto de memoria especificado. |
SnmpUtilOctetsCmp | Compara dos cadenas de octetos. |
SnmpUtilOctetsCpy | Copia una estructura AsnOctetString de origen en una estructura AsnOctetString de destino. |
SnmpUtilOctetsFree | Libera la memoria asignada para la cadena de octeto especificada. |
SnmpUtilOctetsNCmp | Realiza una comparación de dos cadenas de octetos con el número especificado de subidentificadores. |
SnmpUtilOidAppend | Anexa un identificador de objeto de origen, contenido en una estructura AsnObjectIdentifier , a un identificador de objeto de destino. |
SnmpUtilOidCmp | Compara dos identificadores de objeto contenidos en estructuras AsnObjectIdentifier . |
SnmpUtilOidCpy | Copia una estructura AsnObjectIdentifier de origen en una estructura AsnObjectIdentifier de destino. |
SnmpUtilOidFree | Libera la memoria asignada para el identificador de objeto especificado. |
SnmpUtilOidNCmp | Compara dos identificadores de objeto contenidos en estructuras AsnObjectIdentifier con el número especificado de subidentificadores. |
SnmpUtilOidToA | Convierte un identificador de objeto (OID) en una cadena terminada en null. |
SnmpUtilPrintAsnAny | Imprime un valor contenido en una estructura AsnAny para fines de depuración y desarrollo. |
SnmpUtilPrintOid | Da formato al identificador de objeto especificado (OID) e imprime el resultado en el dispositivo de salida estándar. |
SnmpUtilVarBindCpy | Copia una estructura SnmpVarBind de origen en una estructura SnmpVarBind de destino. |
SnmpUtilVarBindListCpy | Copia una estructura SnmpVarBindList de origen en una estructura SnmpVarBindList de destino. |
SnmpUtilVarBindFree | Libera la memoria asignada para la estructura SnmpVarBind especificada. |
SnmpUtilVarBindListFree | Libera la memoria asignada para la estructura SnmpVarBindList especificada. |