Función SnmpSetTimeout (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 SnmpSetTimeout de WinSNMP permite que una aplicación WinSNMP cambie el valor de tiempo de espera para la transmisión de solicitudes de mensajes SNMP. El valor de tiempo de espera 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 SnmpSetTimeout(
[in] HSNMP_ENTITY hEntity,
[in] smiTIMETICKS nPolicyTimeout
);
Parámetros
[in] hEntity
Controlar a la entidad de administración de destino de interés.
[in] nPolicyTimeout
Especifica un nuevo valor de tiempo de espera, en centésimas de segundo, 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 de tiempo de espera. La implementación usa este valor de tiempo de espera cuando 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 |
|---|---|
|
La función SnmpStartup no se completó correctamente. |
|
Error durante la asignación de memoria. |
|
El parámetro hEntity no es válido. |
|
Se produjo un error desconocido o no definido. |
Comentarios
Normalmente, una aplicación de administrador winSNMP, en lugar de una aplicación de agente, llama a la función SnmpSetTimeout .
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 |