Función SnmpSetRetry (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 SnmpSetRetry de WinSNMP permite que una aplicación WinSNMP cambie el valor de recuento de reintentos 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. La implementación de Microsoft WinSNMP almacena el valor en una base de datos.
Sintaxis
SNMPAPI_STATUS SNMPAPI_CALL SnmpSetRetry(
[in] HSNMP_ENTITY hEntity,
[in] smiUINT32 nPolicyRetry
);
Parámetros
[in] hEntity
Controlar a la entidad de administración de destino de interés.
[in] nPolicyRetry
Especifica un nuevo valor para el recuento de reintentos para la entidad de administración. Este valor reemplaza el valor almacenado actualmente en la base de datos de la implementación.
Si este parámetro es igual a cero y el modo de retransmisión actual es igual a SNMPAPI_ON, la implementación selecciona un valor para el recuento de reintentos. La implementación usa este valor cuando 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. 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 |
|---|---|
|
La función SnmpStartup no se completó correctamente. |
|
Error durante la asignación de memoria. |
|
El parámetro hEntity no es válido. |
|
Error desconocido o indefinido. |
Comentarios
Normalmente, una aplicación de administrador de WinSNMP, en lugar de una aplicación de agente, llama a la función SnmpSetRetry .
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 |