Fonction SnmpSetRetransmitMode (winsnmp.h)

Article
08/27/2023

[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 SnmpSetRetransmitMode WinSNMP permet à une application WinSNMP de définir le mode de retransmission. L’implémentation de Microsoft WinSNMP utilise le nouveau mode de retransmission pour régir les délais d’attente de transmission et les tentatives de retransmission sur les appels ultérieurs à la fonction SnmpSendMsg .

Syntaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetRetransmitMode(
  [in] smiUINT32 nRetransmitMode
);

Paramètres

[in] nRetransmitMode

Spécifie une valeur pour le nouveau mode de retransmission. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
SNMPAPI_ON	L’implémentation exécute la stratégie de retransmission de l’application WinSNMP.
SNMPAPI_OFF	L’implémentation n’exécute pas 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_MODE_INVALID	L’implémentation ne prend pas en charge le mode de retransmission demandé.
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 SnmpSetRetransmitMode .

Si une application WinSNMP définit le mode de retransmission sur SNMPAPI_OFF, l’implémentation ne lance pas de tentatives de retransmission pour les nouvelles opérations de communication SNMP. Le nouveau paramètre affecte tous les appels suivants à la fonction SnmpSendMsg , jusqu’à ce que l’application WinSNMP rétablit le mode de retransmission sur SNMPAPI_ON.

L’appel de la fonction SnmpCancelMsg revient à appeler la fonction SnmpSetRetransmitMode , pour un message SNMP spécifique, avec le mode de retransmission égal à SNMPAPI_OFF.

Note Si l’implémentation retourne l’erreur SNMPAPI_MODE_INVALID à un appel à SnmpSetRetransmitMode, l’application WinSNMP doit exécuter la stratégie de retransmission.

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

Configuration requise


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