SnmpGetRetransmitMode-Funktion (winsnmp.h)
[SNMP ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows-Remoteverwaltung, die Microsoft-Implementierung von WS-Man.]
Die WinSNMP-Funktion SnmpGetRetransmitMode gibt die aktuelle Einstellung des Modus für die erneute Übertragung an eine WinSNMP-Anwendung zurück. Die Microsoft WinSNMP-Implementierung verwendet den Erneutübertragungsmodus, um Übertragungstimeouts und Wiederholungsversuche bei Aufrufen der SnmpSendMsg-Funktion zu steuern.
Syntax
SNMPAPI_STATUS SNMPAPI_CALL SnmpGetRetransmitMode(
[out] smiLPUINT32 nRetransmitMode
);
Parameter
[out] nRetransmitMode
Zeiger auf eine variable Long-Integer ohne Vorzeichen, um den aktuellen Modus für die erneute Übertragung zu empfangen, der für die Implementierung wirksam ist. Dieser Parameter kann einen der folgenden Werte annehmen.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert SNMPAPI_SUCCESS.
Wenn die Funktion fehlschlägt, wird der Rückgabewert SNMPAPI_FAILURE. Wenn SnmpGetRetransmitMode fehlschlägt, hat der Wert des nRetransmitMode-Parameters keine Bedeutung für die Anwendung. Rufen Sie SnmpGetLastError auf, um erweiterte Fehlerinformationen zu erhalten, und geben Sie einen NULL-Wert im Sitzungsparameter an. Die SnmpGetLastError-Funktion kann einen der folgenden Fehler zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen. |
|
Während der Speicherbelegung ist ein Fehler aufgetreten. |
|
Es ist ein unbekannter oder nicht definierter Fehler aufgetreten. |
Hinweise
In der Regel ruft eine WinSNMP-Anwendung anstelle einer Agentanwendung die SnmpGetRetransmitMode-Funktion auf. Weitere Informationen finden Sie unter Informationen zur erneuten Übertragung und Verwalten der Richtlinie für die erneute Übertragung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winsnmp.h |
| Bibliothek | Wsnmp32.lib |
| DLL | Wsnmp32.dll |