Funzione SnmpDeleteVb (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 SnmpDeleteVb WinSNMP rimuove una voce di associazione di variabili da un elenco di associazioni di variabili.
Sintassi
SNMPAPI_STATUS SNMPAPI_CALL SnmpDeleteVb(
[in] HSNMP_VBL vbl,
[in] smiUINT32 index
);
Parametri
[in] vbl
Gestire l'elenco di associazioni di variabili da aggiornare.
[in] index
Specifica una variabile long integer senza segno che identifica la voce di associazione di variabili da rimuovere. Questa variabile contiene la posizione della voce di associazione di variabili, all'interno dell'elenco di associazioni di variabili.
I valori validi per questo parametro sono compresi nell'intervallo compreso tra 1 e n, dove 1 indica la prima voce di associazione di variabili nell'elenco delle associazioni di variabili e n è il numero totale di voci nell'elenco di associazioni di variabili. Per altre informazioni, vedere la sezione Osservazioni seguente.
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 parametro index non è valido. |
|
Il parametro vbl non è valido. |
|
Si è verificato un errore sconosciuto o non definito. |
Commenti
Un'applicazione WinSNMP può usare la funzione SnmpDeleteVb per eliminare voci di associazione di variabili non valide. Quando un'unità dati del protocollo di SNMP_PDU_RESPONSE include un errore che indica una voce di associazione di variabili non valida, l'applicazione può chiamare SnmpDeleteVb per eliminare la voce. L'applicazione può quindi inviare di nuovo la richiesta PDU con una chiamata alla funzione SnmpSendMsg , senza la voce di associazione di variabili non valida nell'elenco di associazioni di variabili. Le UNITÀ RICHIESTA includono i tipi di dati SNMP_PDU_GET, SNMP_PDU_GETNEXT e SNMP_PDU_GETBULK PDU.
Dopo che la funzione SnmpDeleteVb elimina una voce di associazione di variabili, il valore di indice di tutte le voci dopo la voce eliminata decrementerà di uno. Una chiamata alla funzione SnmpCountVbl restituisce il nuovo numero totale di voci nell'elenco di associazioni di variabili. Il nuovo totale è inferiore al conteggio restituito da una chiamata a SnmpCountVbl prima della chiamata corrente a SnmpDeleteVb.
Se un'applicazione WinSNMP chiama la funzione SnmpDeleteVb ed elimina l'ultima voce di associazione di variabili in un elenco di associazioni di variabili, il risultato è un elenco di associazioni di variabili vuote. L'elenco di associazioni di variabili ha ancora un handle valido e l'applicazione WinSNMP deve rilasciare l'handle con una chiamata alla funzione SnmpFreeVbl .
Di seguito sono riportati i valori validi da usare per il parametro index :
- Valore restituito da una chiamata alla funzione SnmpCountVbl
- Campo di indice degli errori di un SNMP_PDU_RESPONSE PDU restituito da una chiamata alla funzione SnmpRecvMsg
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 |