structure smiOID (winsnmp.h)

Article
08/27/2023

[SNMP est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Au lieu de cela, utilisez La gestion à distance Windows, qui est l’implémentation Microsoft de WS-Man.]

La structure smiOID WinSNMP transmet des identificateurs d’objet à plusieurs fonctions WinSNMP. La structure reçoit également le nom de variable d’une entrée de liaison de variable dans un appel à la fonction SnmpGetVb .

La structure smiOID contient un pointeur vers un tableau de longueur variable des sous-identificateurs d’un objet nommé. La structure peut être membre de la structure smiVALUE .

Syntaxe

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

Membres

len

Spécifie une valeur entière longue non signée qui indique le nombre d’éléments dans le tableau pointé vers le membre ptr .

ptr

Pointeur vers un tableau d’entiers longs non signés qui représentent les sous-identificateurs de l’identificateur d’objet.

Remarques

Dans une structure smiOID , le format du tableau pointé vers par le membre ptr est un sous-identificateur par élément de tableau. Par exemple, la chaîne « 1.3.6.1 » est un tableau de quatre éléments {1,3,6,1}.

L’implémentation de Microsoft WinSNMP alloue et libère la mémoire pour toutes les structures smiOID de sortie. L’application WinSNMP ne doit pas libérer la mémoire que l’implémentation alloue pour le membre ptr d’une structure smiOID . Au lieu de cela, l’application doit appeler la fonction SnmpFreeDescriptor pour libérer la mémoire.

Étant donné que l’application WinSNMP alloue de la mémoire pour les objets de descripteur d’entrée avec des longueurs variables, elle doit libérer cette mémoire. Pour plus d’informations, consultez Concepts winSNMP Gestion des données.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	winsnmp.h