Funzione SnmpSetPduData (winsnmp.h)
[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 |
|---|---|
|
La funzione SnmpStartup non è stata completata correttamente. |
|
Errore durante l'allocazione della memoria. |
|
Il tipo PDU non è valido. |
|
L'elenco di associazioni di variabili non è valido. |
|
Tutti i parametri di input sono NULL. L'operazione SNMP non è stata eseguita. |
|
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 |