Compartir a través de

Funciones winSNMP

  • 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.]

Las funciones usadas con WinSNMP se dividen en las siguientes agrupaciones funcionales. A continuación se muestra una lista alfabética.

Funciones de comunicaciones de WinSNMP

Las funciones de comunicaciones de WinSNMP proporcionan una interfaz entre la aplicación WinSNMP que llama y la implementación de Microsoft WinSNMP. La implementación controla la comunicación entre la aplicación y otras entidades de administración.

Función Descripción
SnmpCancelMsg Solicita que la implementación de Microsoft WinSNMP cancele los intentos de retransmisión y las notificaciones de tiempo de espera de un mensaje de solicitud SNMP.
SnmpCleanup Informa a la implementación de que una aplicación se está desconectando y ya no requiere recursos asignados.
SnmpCleanupEx Realiza la limpieza cuando no hay llamadas correctas pendientes a SnmpStartup o SnmpStartupEx dentro de una aplicación WinSNMP.
SnmpClose Permite que la implementación desasigne los recursos asociados a una sesión y cierre los mecanismos de comunicación.
SnmpCreateSession Solicita a la implementación que abra una sesión de WinSNMP y asigne recursos y mecanismos de comunicaciones. Al desarrollar nuevas aplicaciones WinSNMP, se recomienda llamar a la función SnmpCreateSession para abrir una sesión de WinSNMP en lugar de llamar a la función SnmpOpen .
SnmpListen Registra o anula el registro de una aplicación WinSNMP como agente SNMP.
SnmpOpen Solicita a la implementación que abra una sesión de WinSNMP y asigne recursos y mecanismos de comunicaciones. Al desarrollar nuevas aplicaciones WinSNMP, se recomienda llamar a la función SnmpCreateSession para abrir una sesión de WinSNMP en lugar de llamar a la función SnmpOpen .
SnmpRecvMsg Devuelve mensajes SNMP y notificaciones de captura pendientes.
SnmpRegister Informa a la implementación de que la aplicación debe registrar o anular el registro de capturas y notificaciones.
SnmpSendMsg Solicita que la implementación transmita una unidad de datos de protocolo.
SnmpStartup Notifica a la implementación que debe realizar procedimientos de inicialización para la aplicación. Una aplicación debe llamar correctamente a la función SnmpStartup antes de llamar a cualquier otra función winSNMP.
SnmpStartupEx Notifica a la implementación de Microsoft WinSNMP que la aplicación WinSNMP requiere los servicios de la implementación. SnmpStartupEx permite la compatibilidad con varios módulos de software independientes que usan WinSNMP dentro de la misma aplicación.
SNMPAPI_CALLBACK Notifica a una sesión de WinSNMP que está disponible un mensaje SNMP o un evento asincrónico. Nota: Esta función de devolución de llamada solo se aplica a las sesiones abiertas como resultado de una llamada a la función SnmpCreateSession .

Funciones de entidad y contexto de WinSNMP

Las funciones de contexto y entidad winSNMP permiten a una aplicación WinSNMP especificar nombres descriptivos para entidades y contextos SNMP. La implementación de Microsoft WinSNMP traduce el nombre a sus componentes SNMPv1 o SNMPv2C mediante la base de datos de la implementación.

Función Descripción
SnmpContextToStr Devuelve una cadena que identifica un contexto SNMP (un conjunto de recursos de objeto administrado).
SnmpEntityToStr Devuelve una cadena que identifica una entidad de administración snmp.
SnmpFreeContext Libera los recursos asignados por la función SnmpStrToContext para un contexto SNMP.
SnmpFreeEntity Libera los recursos asignados por la función SnmpStrToEntity para una entidad de administración snmp.
SnmpSetPort Cambia el puerto asignado a una entidad de destino SNMP.
SnmpStrToContext Devuelve un identificador a la información de contexto snmp específica de la implementación.
SnmpStrToEntity Devuelve un identificador a la información de entidad de administración snmp específica de la implementación.

Funciones de base de datos winSNMP

Las funciones de base de datos WinSNMP proporcionan a una aplicación WinSNMP acceso a la configuración actual en el almacén de información administrativa de la implementación de Microsoft WinSNMP. Estas funciones permiten cambiar el modo de retransmisión y el modo de traducción de entidad y contexto. Las funciones de base de datos también proporcionan a la aplicación la capacidad de manipular los valores de tiempo de espera y recuento de reintentos.

Función Descripción
SnmpGetRetransmitMode Devuelve la configuración actual del modo de retransmisión.
SnmpGetRetry Devuelve el valor de número de reintentos, en unidades, para la retransmisión de solicitudes de mensajes SNMP.
SnmpGetTimeout Devuelve el valor de tiempo de espera, en centésimas de segundo, para la transmisión de solicitudes de mensajes SNMP.
SnmpGetTranslateMode Devuelve la configuración actual del modo de traducción de entidad y contexto.
SnmpGetVendorInfo Recupera información que identifica al proveedor de WinSNMP.
SnmpSetRetransmitMode Cambia el modo de retransmisión.
SnmpSetRetry Cambia el valor de recuento de reintentos para la retransmisión de solicitudes de mensajes SNMP.
SnmpSetTimeout Cambia el valor de tiempo de espera para la transmisión de solicitudes de mensajes SNMP.
SnmpSetTranslateMode Cambia el modo de traducción de entidad y contexto.

Funciones PDU de WinSNMP

Las funciones PDU de WinSNMP permiten que las aplicaciones WinSNMP extraigan y actualicen los elementos de datos (o campos) de una PDU. Esto incluye las PDU devueltas por una llamada a la función SnmpRecvMsg o a la función SnmpDecodeMsg . Las funciones PDU también construyen PDU para su uso en las funciones SnmpSendMsg y SnmpEncodeMsg .

Función Descripción
SnmpCreatePdu Crea e inicializa una unidad de datos de protocolo SNMP.
SnmpDuplicatePdu Duplica una unidad de datos del protocolo SNMP.
SnmpFreePdu Libera los recursos asociados a una unidad de datos de protocolo SNMP creada por snmpCreatePdu o la función SnmpDuplicatePdu .
SnmpGetPduData Devuelve los elementos de datos seleccionados de una unidad de datos del protocolo SNMP especificada.
SnmpSetPduData Novedades elementos de datos seleccionados en una unidad de datos del protocolo SNMP especificada.

Funciones de la utilidad WinSNMP

Las funciones de utilidad WinSNMP permiten que una aplicación WinSNMP administre objetos y mensajes SNMP en la interfaz winSNMP.

Función Descripción
SnmpDecodeMsg Descodifica un mensaje SNMP codificado o serializado en sus componentes constituyentes.
SnmpEncodeMsg Crea un mensaje SNMP codificado.
SnmpFreeDescriptor Indica a la implementación de Microsoft WinSNMP que debe liberar la memoria asignada para un descriptor específico.
SnmpGetLastError Devuelve el último valor de código de error para la última operación SNMP.
SnmpOidCompare Compara dos identificadores de objeto SNMP.
SnmpOidCopy Copia un identificador de objeto SNMP.
SnmpOidToStr Convierte la representación binaria interna de un identificador de objeto SNMP en su formato de cadena numérica de puntos.
SnmpStrToOid Convierte el formato de cadena numérica de puntos de un identificador de objeto SNMP en su representación binaria interna.

Funciones de enlace de variables winSNMP

Las funciones de enlace de variables winSNMP permiten a las aplicaciones WinSNMP construir y manipular listas de enlace de variables e incluirlas en PTU.

Función Descripción
SnmpCountVbl Enumera las entradas de enlace de variables en una lista de enlace de variables especificada.
SnmpCreateVbl Crea una nueva lista de enlaces de variables.
SnmpDeleteVb Quita una entrada de enlace de variables de una lista de enlaces de variables.
SnmpDuplicateVbl Copia una lista de enlaces de variables.
SnmpFreeVbl Libera los recursos de una lista de enlaces de variables asignadas anteriormente por snmpCreateVbl o la función SnmpDuplicateVbl .
SnmpGetVb Recupera información de una entrada de enlace de variable especificada.
SnmpSetVb Cambia las entradas de enlace de variables en una lista de enlaces de variables; anexa nuevas entradas de enlace de variables a una lista de enlaces de variables existente.

Lista alfabética de funciones winSNMP