Funzione SnmpSetVb (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 SnmpSetVb WinSNMP modifica le voci di associazione delle variabili in un elenco di associazioni di variabili. Questa funzione aggiunge anche nuove voci di associazione di variabili a un elenco di associazioni di variabili esistenti.
Sintassi
SNMPAPI_STATUS SNMPAPI_CALL SnmpSetVb(
[in] HSNMP_VBL vbl,
[in] smiUINT32 index,
[in] smiLPCOID name,
[in] smiLPCVALUE value
);
Parametri
[in] vbl
Gestire l'elenco di associazioni di variabili da aggiornare.
[in] index
Specifica una variabile integer long senza segno che contiene la posizione della voce di associazione di variabili, all'interno dell'elenco associazioni di variabili, se si tratta di un'operazione di aggiornamento. Se si tratta di un'operazione di accodamento, questo parametro deve essere uguale a zero. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
[in] name
Puntatore a una struttura smiOID che rappresenta il nome della variabile da aggiungere o modificare. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
[in] value
Puntatore a una struttura smiVALUE . La struttura contiene il valore associato alla variabile specificata dal parametro name .
Valore restituito
Se la funzione ha esito positivo, il valore restituito è la posizione della voce di associazione di variabili aggiornata o aggiunta nell'elenco associazioni di variabili. Per altre informazioni, vedere la sezione Osservazioni seguenti.
Se la funzione ha esito negativo, il valore restituito è SNMPAPI_FAILURE. Per ottenere informazioni sull'errore estese, 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 vbl non è valido. |
|
Il parametro di indice non è valido. |
|
Il parametro name non è valido. |
|
Il membro della sintassi della struttura a cui fa riferimento il parametro value non è valido. |
|
Si è verificato un errore sconosciuto o non definito. |
Commenti
Valori validi per l'intervallo di parametri di indice da zero a n. Il valore zero indica un'operazione di accodamento. Il valore n è il numero totale di voci di associazione di variabili nell'elenco associazioni di variabili. Un'applicazione WinSNMP deve chiamare la funzione SnmpCountVbl prima di chiama SnmpSetVb per ottenere il numero totale di voci di associazione di variabili.
Se la funzione esegue correttamente un'operazione di aggiornamento, il valore restituito equivale al valore del parametro di indice . Se la funzione aggiunge una voce di associazione di variabili, il valore restituito è n + 1.
Se il parametro name non è NULL, ma il parametro value è NULL, l'implementazione di Microsoft WinSNMP inizializza la nuova voce di associazione di variabili con il membro valore impostato su NULL e con il membro della sintassi impostato su SNMP_SYNTAX_.
Se il parametro di indice non è uguale a zero e il parametro name è NULL, l'implementazione di Microsoft WinSNMP aggiorna solo il valore della variabile puntata dal parametro index .
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 |