SnmpSetRetransmitMode-Funktion (winsnmp.h)

Artikel
08/27/2023

[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.

Wert	Bedeutung
SNMPAPI_ON	Die Implementierung führt die Richtlinie für die erneute Übertragung der WinSNMP-Anwendung aus.
SNMPAPI_OFF	Die Implementierung führt die Richtlinie für die erneute Übertragung der WinSNMP-Anwendung nicht aus.

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
SNMPAPI_NOT_INITIALIZED	Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen.
SNMPAPI_ALLOC_ERROR	Während der Speicherbelegung ist ein Fehler aufgetreten.
SNMPAPI_MODE_INVALID	Die Implementierung unterstützt den angeforderten Modus für die erneute Übertragung nicht.
SNMPAPI_OTHER_ERROR	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.

Hinweis Wenn die Implementierung den Fehler SNMPAPI_MODE_INVALID einen Aufruf von SnmpSetRetransmitMode zurückgibt, muss die WinSNMP-Anwendung die Richtlinie für die erneute Übertragung ausführen.

Weitere Informationen finden Sie unter Informationen zur erneuten Übertragung und Verwalten der Richtlinie für die erneute Übertragung.

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