SnmpSetRetransmitMode-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 SnmpSetRetransmitMode-Funktion ermöglicht es einer WinSNMP-Anwendung, den Modus für die erneute Übertragung festzulegen. Die Microsoft WinSNMP-Implementierung verwendet den neuen Modus für die erneute Übertragung, um Timeouts für die Übertragung und wiederholungsversuche bei nachfolgenden Aufrufen der SnmpSendMsg-Funktion zu steuern.
Syntax
SNMPAPI_STATUS SNMPAPI_CALL SnmpSetRetransmitMode(
[in] smiUINT32 nRetransmitMode
);
Parameter
[in] nRetransmitMode
Gibt einen Wert für den neuen Modus für die erneute Übertragung an. Dieser Parameter muss einen der folgenden Werte aufweisen.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert SNMPAPI_SUCCESS.
Wenn die Funktion fehlschlägt, wird der Rückgabewert SNMPAPI_FAILURE. 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. |
|
Die Implementierung unterstützt den angeforderten Modus für die erneute Übertragung nicht. |
|
Es ist ein unbekannter oder nicht definierter Fehler aufgetreten. |
Hinweise
In der Regel ruft eine WinSNMP-Manageranwendung anstelle einer Agentanwendung die SnmpSetRetransmitMode-Funktion auf.
Wenn eine WinSNMP-Anwendung den Erneutübertragungsmodus auf SNMPAPI_OFF festlegt, initiiert die Implementierung keine Neuübertragungsversuche für neue SNMP-Kommunikationsvorgänge. Die neue Einstellung wirkt sich auf alle nachfolgenden Aufrufe der SnmpSendMsg-Funktion aus, bis die WinSNMP-Anwendung den Modus für die erneute Übertragung wieder auf SNMPAPI_ON festlegt.
Das Aufrufen der SnmpCancelMsg-Funktion entspricht dem Aufrufen der SnmpSetRetransmitMode-Funktion für eine bestimmte SNMP-Nachricht, wobei der Modus für die erneute Übertragung gleich SNMPAPI_OFF ist.
Anforderungen
| 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 |