Función SnmpSetRetransmitMode (winsnmp.h)

Artículo
08/27/2023

[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 SnmpSetRetransmitMode de WinSNMP permite que una aplicación WinSNMP establezca el modo de retransmisión. La implementación de Microsoft WinSNMP usa el nuevo modo de retransmisión para controlar los tiempos de espera de transmisión y los intentos de retransmisión en llamadas posteriores a la función SnmpSendMsg .

Sintaxis

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetRetransmitMode(
  [in] smiUINT32 nRetransmitMode
);

Parámetros

[in] nRetransmitMode

Especifica un valor para el nuevo modo de retransmisión. Este parámetro puede ser uno de los siguientes valores.

Value	Significado
SNMPAPI_ON	La implementación ejecuta la directiva de retransmisión de la aplicación WinSNMP.
SNMPAPI_OFF	La implementación no ejecuta la directiva de retransmisión de la aplicación WinSNMP.

Valor devuelto

Si la función se realiza correctamente, se SNMPAPI_SUCCESS el valor devuelto.

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
SNMPAPI_NOT_INITIALIZED	La función SnmpStartup no se completó correctamente.
SNMPAPI_ALLOC_ERROR	Error durante la asignación de memoria.
SNMPAPI_MODE_INVALID	La implementación no admite el modo de retransmisión solicitado.
SNMPAPI_OTHER_ERROR	Se produjo un error desconocido o no definido.

Comentarios

Normalmente, una aplicación de administrador de WinSNMP, en lugar de una aplicación de agente, llama a la función SnmpSetRetransmitMode .

Si una aplicación WinSNMP establece el modo de retransmisión en SNMPAPI_OFF, la implementación no inicia intentos de retransmisión para nuevas operaciones de comunicaciones SNMP. La nueva configuración afecta a todas las llamadas posteriores a la función SnmpSendMsg , hasta que la aplicación WinSNMP establece el modo de retransmisión en SNMPAPI_ON.

Llamar a la función SnmpCancelMsg equivale a llamar a la función SnmpSetRetransmitMode , para un mensaje SNMP específico, con el modo de retransmisión igual a SNMPAPI_OFF.

Nota Si la implementación devuelve el error SNMPAPI_MODE_INVALID a una llamada a SnmpSetRetransmitMode, la aplicación WinSNMP debe ejecutar la directiva de retransmisión.

Para obtener más información, vea Acerca de la retransmisión y administración de la directiva de retransmisión.

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