struttura smiOID (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 struttura smiOID WinSNMP passa gli identificatori di oggetto a più funzioni WinSNMP. La struttura riceve anche il nome della variabile di una voce di associazione di variabili in una chiamata alla funzione SnmpGetVb .

La struttura smiOID contiene un puntatore a una matrice di lunghezza variabile dei subidentifier di un oggetto denominato. La struttura può essere un membro della struttura smiVALUE .

Sintassi

typedef struct {
  smiUINT32   len;
  smiLPUINT32 ptr;
} smiOID, *smiLPOID;

Members

len

Specifica un valore intero lungo senza segno che indica il numero di elementi nella matrice a cui punta il membro ptr .

ptr

Puntatore a una matrice di interi lunghi senza segno che rappresentano i sottoidentifier dell'identificatore dell'oggetto.

Commenti

In una struttura smiOID il formato della matrice puntato dal membro ptr è un sottoidentifier per elemento array. Ad esempio, la stringa "1.3.6.1" è una matrice di quattro elementi {1,3,6,1}.

L'implementazione di Microsoft WinSNMP alloca e dealloca la memoria per tutte le strutture smiOID di output. L'applicazione WinSNMP non deve liberare memoria che l'implementazione alloca per il membro ptr di una struttura smiOID . L'applicazione deve invece chiamare la funzione SnmpFreeDescriptor per liberare la memoria.

Poiché l'applicazione WinSNMP alloca memoria per gli oggetti descrittori di input con lunghezze variabili, deve liberare tale memoria. 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]
Intestazione	winsnmp.h