Función SnmpGetTimeout (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 SnmpGetTimeout de WinSNMP devuelve el valor de tiempo de espera, en centésimas de segundo, 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.
Sintaxis
SNMPAPI_STATUS SNMPAPI_CALL SnmpGetTimeout(
[in] HSNMP_ENTITY hEntity,
[out] smiLPTIMETICKS nPolicyTimeout,
[out] smiLPTIMETICKS nActualTimeout
);
Parámetros
[in] hEntity
Controlar a la entidad de administración de destino de interés.
[out] nPolicyTimeout
Puntero a una variable de entero para recibir el valor de tiempo de espera, en centésimas de segundo, 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] nActualTimeout
Puntero a una variable de entero para recibir el último intervalo de respuesta real o estimado 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 |
|---|---|
|
La función SnmpStartup no se completó correctamente. |
|
Error durante la asignación de memoria. |
|
El parámetro hEntity no es válido. |
|
Los parámetros nPolicyRetry y nActualRetry son NULL. No se realizó la operación. |
|
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 SnmpGetTimeout .
El período de tiempo de espera es el intervalo entre la llamada de la aplicación a la función SnmpSendMsg y su llamada a la función SnmpRecvMsg .
Una aplicación WinSNMP puede modificar el valor de tiempo de espera con una llamada a la función SnmpSetTimeout .
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 |