Función SnmpGetRetry (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 SnmpGetRetry de WinSNMP devuelve el valor de número de reintentos, en unidades, para la retransmisión de solicitudes de mensajes SNMP. El recuento de reintentos se aplica a las llamadas que realiza una aplicación WinSNMP a la función SnmpSendMsg para una entidad de administración especificada.

Sintaxis

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetRetry(
  [in]  HSNMP_ENTITY hEntity,
  [out] smiLPUINT32  nPolicyRetry,
  [out] smiLPUINT32  nActualRetry
);

Parámetros

[in] hEntity

Controlar a la entidad de administración de destino de interés.

[out] nPolicyRetry

Puntero a una variable de entero largo sin signo para recibir el valor de número de reintentos para la entidad de administración especificada. Este es un valor que la implementación de Microsoft WinSNMP almacena en una base de datos. Si no necesita la información devuelta en este parámetro, nPolicyRetry debe ser un puntero NULL .

[out] nActualRetry

Puntero a una variable de entero largo sin signo para recibir el último recuento real o estimado de reintentos para la entidad de destino, según lo indicado por la implementación. Si no necesita la información devuelta en este parámetro, nActualRetry debe ser un puntero NULL . Si este parámetro es un puntero válido, la función devuelve 0. Para obtener más información, vea la siguiente sección Comentarios.

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_ENTITY_INVALID	El parámetro hEntity no es válido.
SNMPAPI_NOOP	Los parámetros nPolicyRetry y nActualRetry son NULL. No se realizó la operación.
SNMPAPI_OTHER_ERROR	Se produjo un error desconocido o no definido.

Comentarios

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

Una aplicación WinSNMP puede modificar el valor de recuento de reintentos con una llamada a la función SnmpSetRetry .

La aplicación WinSNMP puede supervisar el valor del parámetro nActualRetry y compararlo con el valor del parámetro nPolicyRetry para optimizar el rendimiento de la transmisión. Para obtener más información, vea 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

SnmpGetRetransmitMode

SnmpSetRetransmitMode

SnmpSetRetry

Funciones winSNMP

Introducción a la API winSNMP