structure smiOCTETS (winsnmp.h)

Article
03/06/2024

[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. Utilisez plutôt Windows Remote Management, qui est l’implémentation Microsoft de WS-Man.]

La structure smiOCTETS WinSNMP transmet des chaînes de contexte à plusieurs fonctions WinSNMP. La structure décrit et reçoit également des messages SNMP encodés.

La structure smiOCTETS contient un pointeur vers une chaîne d’octet SNMP de longueur variable. La structure peut être membre de la structure smiVALUE .

Syntaxe

typedef struct {
  smiUINT32 len;
  smiLPBYTE ptr;
} smiOCTETS, *smiLPOCTETS;

Membres

len

Spécifie une valeur entière longue non signée qui indique le nombre d’octets dans le tableau de chaînes d’octets pointé par le membre ptr .

ptr

Pointeur vers un tableau d’octets qui contient la chaîne d’octets intéressante. Un octet se terminant par null n’est pas nécessaire.

Remarques

L’implémentation De Microsoft WinSNMP alloue et libère de la mémoire pour toutes les structures smiOCTETS de sortie. L’application WinSNMP ne doit pas libérer de mémoire que l’implémentation alloue au membre ptr d’une structure smiOCTETS . 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

Condition requise	Valeur
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