Freigeben über


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.

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. 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
SNMPAPI_NOT_INITIALIZED
Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen.
SNMPAPI_ALLOC_ERROR
Während der Speicherbelegung ist ein Fehler aufgetreten.
SNMPAPI_OTHER_ERROR
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

Weitere Informationen

SnmpSetRetransmitMode

SnmpStartup

WinSNMP-Funktionen

Übersicht über winSNMP-API