SnmpSetRetry-Funktion (winsnmp.h)
[SNMP ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows-Remoteverwaltung, die Microsoft-Implementierung von WS-Man.]
Die WinSNMP SnmpSetRetry-Funktion ermöglicht es einer WinSNMP-Anwendung, den Wert der Wiederholungsanzahl für die erneute Übertragung von SNMP-Nachrichtenanforderungen zu ändern. Die Wiederholungsanzahl gilt für Aufrufe, die eine WinSNMP-Anwendung an die SnmpSendMsg-Funktion für eine angegebene Verwaltungsentität sendet. Die Microsoft WinSNMP-Implementierung speichert den Wert in einer Datenbank.
Syntax
SNMPAPI_STATUS SNMPAPI_CALL SnmpSetRetry(
[in] HSNMP_ENTITY hEntity,
[in] smiUINT32 nPolicyRetry
);
Parameter
[in] hEntity
Handle an die zielverwaltungsentität von interesse.
[in] nPolicyRetry
Gibt einen neuen Wert für die Wiederholungsanzahl für die Verwaltungsentität an. Dieser Wert ersetzt den Wert, der derzeit in der Datenbank der Implementierung gespeichert ist.
Wenn dieser Parameter gleich 0 ist und der aktuelle Wiederübertragungsmodus gleich SNMPAPI_ON ist, wählt die Implementierung einen Wert für die Wiederholungsanzahl aus. Die Implementierung verwendet diesen Wert, wenn sie die Erneutübertragungsrichtlinie der WinSNMP-Anwendung ausführt.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert SNMPAPI_SUCCESS.
Wenn die Funktion fehlschlägt, wird der Rückgabewert SNMPAPI_FAILURE. Um erweiterte Fehlerinformationen abzurufen, rufen Sie SnmpGetLastError auf, indem Sie einen NULL-Wert im Sitzungsparameter angeben. Die SnmpGetLastError-Funktion kann einen der folgenden Fehler zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen. |
|
Während der Speicherzuordnung ist ein Fehler aufgetreten. |
|
Der hEntity-Parameter ist ungültig. |
|
Ein unbekannter oder nicht definierter Fehler ist aufgetreten. |
Hinweise
In der Regel ruft eine WinSNMP-Manageranwendung anstelle einer Agentanwendung die SnmpSetRetry-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 |