SnmpGetRetry, fonction (winsnmp.h)
[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. Utilisez plutôt Windows Remote Management, qui est l’implémentation Microsoft de WS-Man.]
La fonction SnmpGetRetry WinSNMP retourne la valeur du nombre de nouvelles tentatives, en unités, pour la retransmission des demandes de message SNMP. Le nombre de nouvelles tentatives s’applique aux appels qu’une application WinSNMP effectue à la fonction SnmpSendMsg pour une entité de gestion spécifiée.
Syntaxe
SNMPAPI_STATUS SNMPAPI_CALL SnmpGetRetry(
[in] HSNMP_ENTITY hEntity,
[out] smiLPUINT32 nPolicyRetry,
[out] smiLPUINT32 nActualRetry
);
Paramètres
[in] hEntity
Gérez vers l’entité de gestion de destination qui vous intéresse.
[out] nPolicyRetry
Pointeur vers une variable entière longue non signée pour recevoir la valeur du nombre de nouvelles tentatives pour l’entité de gestion spécifiée. Il s’agit d’une valeur que l’implémentation Microsoft WinSNMP stocke dans une base de données. Si vous n’avez pas besoin des informations retournées dans ce paramètre, nPolicyRetry doit être un pointeur NULL .
[out] nActualRetry
Pointeur vers une variable entière longue non signée pour recevoir le dernier nombre réel ou estimé de nouvelles tentatives pour l’entité de destination, comme indiqué par l’implémentation. Si vous n’avez pas besoin des informations retournées dans ce paramètre, nActualRetry doit être un pointeur NULL . Si ce paramètre est un pointeur valide, la fonction retourne 0. Pour plus d’informations, consultez la section Remarques suivante.
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 |
|---|---|
|
La fonction SnmpStartup ne s’est pas terminée correctement. |
|
Une erreur s’est produite lors de l’allocation de mémoire. |
|
Le paramètre hEntity n’est pas valide. |
|
Les paramètres nPolicyRetry et nActualRetry sont tous deux NULL. L’opération n’a pas été effectuée. |
|
Une erreur inconnue ou non définie s’est produite. |
Remarques
En général, une application WinSNMP, plutôt qu’une application d’agent, appelle la fonction SnmpGetRetry .
Une application WinSNMP peut modifier la valeur du nombre de nouvelles tentatives avec un appel à la fonction SnmpSetRetry .
L’application WinSNMP peut surveiller la valeur du paramètre nActualRetry et la comparer à la valeur du paramètre nPolicyRetry pour optimiser les performances de transmission. 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 |