Fonction SnmpGetRetransmitMode (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 SnmpGetRetransmitMode WinSNMP retourne le paramètre actuel du mode de retransmission à une application WinSNMP. L’implémentation de Microsoft WinSNMP utilise le mode de retransmission pour régir les délais d’attente de transmission et les tentatives de retransmission sur les appels à la fonction SnmpSendMsg .

Syntaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetRetransmitMode(
  [out] smiLPUINT32 nRetransmitMode
);

Paramètres

[out] nRetransmitMode

Pointeur vers une variable entière longue non signée pour recevoir le mode de retransmission actuel en vigueur pour l’implémentation. 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. Si SnmpGetRetransmitMode échoue, la valeur du paramètre nRetransmitMode n’a aucune signification pour l’application. 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_OTHER_ERROR
 Une erreur inconnue ou non définie s’est produite.

Remarques

En général, une application WinSNMP, plutôt qu’une application agent, appelle la fonction SnmpGetRetransmitMode . 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

SnmpSetRetransmitMode

SnmpStartup

Fonctions WinSNMP

Vue d’ensemble de l’API WinSNMP