Funzione SnmpCreateVbl (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 SnmpCreateVbl WinSNMP crea un nuovo elenco di associazioni di variabili per l'applicazione WinSNMP chiamante. Se i parametri nome e valore non sono NULL, SnmpCreateVbl usa i relativi valori per creare la prima voce di associazione di variabili per il nuovo elenco di associazioni di variabili. La funzione SnmpCreateVbl restituisce un handle al nuovo elenco di associazioni di variabili e alloca la memoria necessaria.

Sintassi

HSNMP_VBL SNMPAPI_CALL SnmpCreateVbl(
  [in] HSNMP_SESSION session,
  [in] smiLPCOID     name,
  [in] smiLPCVALUE   value
);

Parametri

[in] session

Gestire la sessione WinSNMP.

[in] name

Puntatore a una struttura smiOID contenente il nome della variabile per la prima voce di associazione di variabili. Questo parametro può essere NULL. Per altre informazioni, vedere la sezione Osservazioni seguente.

[in] value

Puntatore a una struttura smiVALUE che contiene un valore da associare alla variabile nella prima voce di associazione di variabili. Questo parametro può essere NULL. Per altre informazioni, vedere la sezione Osservazioni seguente.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per un nuovo elenco di associazioni di variabili.

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_SESSION_INVALID	L'handle di sessione non è valido.
SNMPAPI_OID_INVALID	Il parametro name fa riferimento a una struttura smiOID non valida.
SNMPAPI_SYNTAX_INVALID	Il membro della sintassi della struttura a cui punta il parametro value non è valido.
SNMPAPI_OTHER_ERROR	Si è verificato un errore sconosciuto o non definito.

Commenti

La funzione SnmpCreateVbl usa i valori dei parametri nome e valore per creare e inizializzare la prima voce di associazione di variabili di un nuovo elenco di associazioni di variabili. Se il parametro name è NULL, l'implementazione di Microsoft WinSNMP ignora il parametro value e crea un elenco di associazioni di variabili vuote.

Se il parametro name non è NULL, ma il parametro value è NULL, l'implementazione crea e inizializza la prima voce di associazione di variabili nell'elenco di associazioni di variabili. Inizializza il membro della sintassi della struttura a cui punta il parametro value con il valore SNMP_SYNTAX_NULL.

L'applicazione WinSNMP deve rilasciare le risorse associate a ogni elenco di associazioni di variabili. Questa operazione deve essere eseguita associando ogni chiamata alle funzioni SnmpCreateVbl e SnmpDuplicateVbl con una chiamata corrispondente alla funzione SnmpFreeVbl . Per evitare perdite di memoria, un'applicazione WinSNMP deve chiamare SnmpFreeVbl prima di riutilizzare l'handle in un elenco di associazioni di variabili in una chiamata successiva a SnmpCreateVbl o SnmpDuplicateVbl. Per altre informazioni, vedere Concetti di Gestione dati WinSNMP.

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