SnmpSetPduData-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 SnmpSetPduData-Funktion aktualisiert ausgewählte Datenfelder in der angegebenen SNMP-Protokolldateneinheit (PDU).
Syntax
SNMPAPI_STATUS SNMPAPI_CALL SnmpSetPduData(
[in] HSNMP_PDU PDU,
[in] const smiINT *PDU_type,
[in] const smiINT32 *request_id,
[in] const smiINT *non_repeaters,
[in] const smiINT *max_repetitions,
[in] const HSNMP_VBL *varbindlist
);
Parameter
[in] PDU
Handle für eine SNMP-PDU.
[in] PDU_type
Zeiger auf eine Variable mit einem Wert, um das feld PDU_type der angegebenen PDU zu aktualisieren. Dieser Parameter kann auch NULL sein.
[in] request_id
Zeiger auf eine Variable mit einem Wert, um das feld request_id der angegebenen PDU zu aktualisieren. Dieser Parameter kann auch NULL sein.
[in] non_repeaters
Wenn der parameter PDU_type gleich SNMP_PDU_GETBULK ist, verweist dieser Parameter auf eine Variable mit einem Wert, um das non_repeaters Feld der angegebenen PDU zu aktualisieren. Die Microsoft WinSNMP-Implementierung ignoriert diesen Parameter für andere PDU-Typen. Dieser Parameter kann auch NULL sein.
[in] max_repetitions
Wenn der parameter PDU_type gleich SNMP_PDU_GETBULK ist, verweist dieser Parameter auf eine Variable mit einem Wert, um das max_repetitions Feld der angegebenen PDU zu aktualisieren. Die Implementierung ignoriert diesen Parameter für andere PDU-Typen. Dieser Parameter kann auch NULL sein.
[in] varbindlist
Zeiger auf eine Variable mit einem Wert, der das Handle in das Listenfeld für Variablenbindungen der angegebenen PDU aktualisiert. Dieser Parameter kann auch NULL sein.
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. 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. |
|
Der PDU-Typ ist ungültig. |
|
Die Variablenbindungsliste ist ungültig. |
|
Alle Eingabeparameter sind NULL. Der SNMP-Vorgang wurde nicht ausgeführt. |
|
Es ist ein unbekannter oder nicht definierter Fehler aufgetreten. |
Hinweise
Alle Parameter der SnmpSetPduData-Funktion sind erforderlich. Alle Parameter mit Ausnahme des PDU-Parameters können jedoch NULL sein. Wenn die WinSNMP-Anwendung NULL in einem Parameter übergibt, aktualisiert SnmpSetPduData das entsprechende Feld in der PDU nicht. Da SnmpSetPduData Parameter als Zeiger auf Werte übergibt, kann eine Anwendung ein PDU-Feld weiterhin mit NULL aktualisieren.
Der Wert eines PDU-Felds kann allein gültig sein, kann aber in Kombination mit Werten für andere Felder ungültig werden. Die Implementierung überprüft die PDU und die anderen Nachrichtenelemente, wenn die Anwendung die Funktionen SnmpSendMsg oder SnmpEncodeMsg aufruft . Die Implementierung lehnt ungültige PDUs ab.
Der einzige Typ von Trap-PDU, die Sie mit einem Aufruf der SnmpSetPduData-Funktion aktualisieren können, ist eine SNMPv2C-Trap-PDU.
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 |