SnmpDuplicatePdu-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 SnmpDuplicatePdu dupliziert die SNMP-Protokolldateneinheit (PDU), die vom PDU-Parameter identifiziert wird, und weist alle erforderlichen Speicher für die doppelte PDU zu.
Syntax
HSNMP_PDU SNMPAPI_CALL SnmpDuplicatePdu(
[in] HSNMP_SESSION session,
[in] HSNMP_PDU PDU
);
Parameter
[in] session
Handle für die WinSNMP-Sitzung.
[in] PDU
Handle für die zu duplizierende PDU. Die SnmpDuplicatePdu-Funktion stellt für jede PDU in der aufrufenden Anwendung ein eindeutiges Handle bereit.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle, das die neue doppelte PDU identifiziert.
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. |
|
Das Sitzungshandle ist ungültig. |
|
Das PDU-Handle ist ungültig. |
|
Es ist ein unbekannter oder nicht definierter Fehler aufgetreten. |
Hinweise
Um Ressourcen freizugeben, die von der SnmpDuplicatePdu-Funktion für eine neue PDU zugewiesen wurden, muss eine WinSNMP-Anwendung die SnmpFreePdu-Funktion aufrufen.
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 |