Funzione SnmpSetPduData (winsnmp.h)

Articolo
08/27/2023

[SNMP è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece Gestione remota Windows, ovvero l'implementazione Microsoft di WS-Man.

La funzione SnmpSetPduData WinSNMP aggiorna i campi dati selezionati nell'unità dati del protocollo SNMP (PDU) specificata.

Sintassi

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
);

Parametri

[in] PDU

Handle per un PDU SNMP.

[in] PDU_type

Puntatore a una variabile con un valore per aggiornare il campo PDU_type della PDU specificata. Questo parametro può anche essere NULL.

[in] request_id

Puntatore a una variabile con un valore per aggiornare il campo request_id della PDU specificata. Questo parametro può anche essere NULL.

[in] non_repeaters

Se il parametro PDU_type è uguale a SNMP_PDU_GETBULK, questo parametro punta a una variabile con un valore per aggiornare il campo non_repeaters della PDU specificata. L'implementazione di Microsoft WinSNMP ignora questo parametro per altri tipi PDU. Questo parametro può anche essere NULL.

[in] max_repetitions

Se il parametro PDU_type è uguale a SNMP_PDU_GETBULK, questo parametro punta a una variabile con un valore per aggiornare il campo max_repetitions del PDU specificato. L'implementazione ignora questo parametro per altri tipi PDU. Questo parametro può anche essere NULL.

[in] varbindlist

Puntatore a una variabile con un valore che aggiorna l'handle al campo elenco delle associazioni di variabili del PDU specificato. Questo parametro può anche essere NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene SNMPAPI_SUCCESS.

Se la funzione ha esito negativo, il valore restituito viene SNMPAPI_FAILURE. Per ottenere informazioni estese sull'errore, chiamare SnmpGetLastError. La funzione SnmpGetLastError può restituire uno degli errori seguenti.

Codice restituito	Descrizione
SNMPAPI_NOT_INITIALIZED	La funzione SnmpStartup non è stata completata correttamente.
SNMPAPI_ALLOC_ERROR	Errore durante l'allocazione della memoria.
SNMPAPI_PDU_INVALID	Il tipo PDU non è valido.
SNMPAPI_VBL_INVALID	L'elenco di associazioni di variabili non è valido.
SNMPAPI_NOOP	Tutti i parametri di input sono NULL. L'operazione SNMP non è stata eseguita.
SNMPAPI_OTHER_ERROR	Si è verificato un errore sconosciuto o non definito.

Commenti

Tutti i parametri della funzione SnmpSetPduData sono obbligatori. Tuttavia, tutti i parametri, ad eccezione del parametro PDU , possono essere NULL. Se l'applicazione WinSNMP passa NULL in un parametro, SnmpSetPduData non aggiorna il campo corrispondente nel PDU. Poiché SnmpSetPduData passa i parametri come puntatori ai valori, un'applicazione può comunque aggiornare un campo PDU con NULL.

Il valore di un campo PDU può essere valido da solo, ma può essere invalidato in combinazione con valori per altri campi. L'implementazione convalida il PDU e gli altri elementi del messaggio quando l'applicazione chiama snmpSendMsg o le funzioni SnmpEncodeMsg . L'implementazione rifiuta PDU non validi.

L'unico tipo di PDU trap che è possibile aggiornare con una chiamata alla funzione SnmpSetPduData è un PDU trap SNMPv2C.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winsnmp.h
Libreria	Wsnmp32.lib
DLL	Wsnmp32.dll

Vedi anche

SnmpEncodeMsg

SnmpSendMsg

Funzioni WinSNMP

Panoramica dell'API WinSNMP

Share via