Fonction SnmpSetTimeout (winsnmp.h)

  • Article

[SNMP est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Au lieu de cela, utilisez La gestion à distance Windows, qui est l’implémentation Microsoft de WS-Man.]

La fonction SnmpSetTimeout WinSNMP permet à une application WinSNMP de modifier la valeur de délai d’attente pour la transmission des demandes de messages SNMP. La valeur de délai d’attente s’applique aux appels qu’une application WinSNMP effectue à la fonction SnmpSendMsg pour une entité de gestion spécifiée. L’implémentation de Microsoft WinSNMP stocke la valeur dans une base de données.

Syntaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetTimeout(
  [in] HSNMP_ENTITY hEntity,
  [in] smiTIMETICKS nPolicyTimeout
);

Paramètres

[in] hEntity

Gérez vers l’entité de gestion de destination qui vous intéresse.

[in] nPolicyTimeout

Spécifie une nouvelle valeur de délai d’attente, en centièmes de seconde, pour l’entité de gestion. Cette valeur remplace la valeur actuellement stockée dans la base de données de l’implémentation.

Si ce paramètre est égal à zéro et que le mode de retransmission actuel est égal à SNMPAPI_ON, l’implémentation sélectionne une valeur de délai d’attente. L’implémentation utilise cette valeur de délai d’attente lorsqu’elle exécute la stratégie de retransmission de l’application WinSNMP.

Valeur retournée

Si la fonction réussit, la valeur de retour est SNMPAPI_SUCCESS.

Si la fonction échoue, la valeur de retour est SNMPAPI_FAILURE. Pour obtenir des informations d’erreur étendues, appelez SnmpGetLastError en spécifiant une valeur NULL dans son paramètre de session . La fonction SnmpGetLastError peut retourner l’une des erreurs suivantes.

Code de retour Description
SNMPAPI_NOT_INITIALIZED
 La fonction SnmpStartup ne s’est pas terminée correctement.
SNMPAPI_ALLOC_ERROR
 Une erreur s’est produite lors de l’allocation de mémoire.
SNMPAPI_ENTITY_INVALID
 Le paramètre hEntity n’est pas valide.
SNMPAPI_OTHER_ERROR
 Une erreur inconnue ou non définie s’est produite.

Remarques

En général, une application de gestionnaire WinSNMP, plutôt qu’une application agent, appelle la fonction SnmpSetTimeout .

Pour plus d’informations, consultez À propos de la retransmission et gestion de la stratégie de retransmission.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winsnmp.h
Bibliothèque Wsnmp32.lib
DLL Wsnmp32.dll

Voir aussi

SnmpGetRetransmitMode

SnmpGetTimeout

SnmpSetRetransmitMode

Fonctions WinSNMP

Vue d’ensemble de l’API WinSNMP