Función SnmpGetRetransmitMode (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 la administración remota de Windows, que es la implementación de Microsoft de WS-Man.]

La función SnmpGetRetransmitMode de WinSNMP devuelve la configuración actual del modo de retransmisión a una aplicación WinSNMP. La implementación de Microsoft WinSNMP usa el modo de retransmisión para controlar los tiempos de espera de transmisión y los intentos de retransmisión en las llamadas a la función SnmpSendMsg .

Sintaxis

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetRetransmitMode(
  [out] smiLPUINT32 nRetransmitMode
);

Parámetros

[out] nRetransmitMode

Puntero a una variable de entero largo sin signo para recibir el modo de retransmisión actual en vigor para la implementación. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
SNMPAPI_ON	La implementación está ejecutando 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 ejecuta correctamente, el valor devuelto es SNMPAPI_SUCCESS.

Si se produce un error en la función, el valor devuelto es SNMPAPI_FAILURE. Si se produce un error en SnmpGetRetransmitMode , el valor del parámetro nRetransmitMode no tiene ningún significado para la aplicación. 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_OTHER_ERROR	Error desconocido o indefinido.

Comentarios

Normalmente, una aplicación WinSNMP, en lugar de una aplicación de agente, llama a la función SnmpGetRetransmitMode . Para obtener más información, consulte Acerca de la retransmisión y administración de la directiva de retransmisió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	winsnmp.h
Library	Wsnmp32.lib
Archivo DLL	Wsnmp32.dll

Consulte también

SnmpSetRetransmitMode

SnmpStartup

Funciones winSNMP

Introducción a la API de WinSNMP