Descripteurs WinSNMP

Dans l’environnement de programmation WinSNMP, un descripteur est l’une des deux structures suivantes :

  • Structure smiOCTETS qui décrit une variable de chaîne d’octets
  • Structure smiOID qui décrit une variable d’identificateur d’objet SNMP

Un descripteur WinSNMP est une structure qui a deux membres : un membre de longueur, len, et un membre pointeur, ptr. Le membre ptr pointe vers la chaîne d’octets ou l’identificateur d’objet d’intérêt. Le membre ptr peut être le type de données smiLPBYTE ou smiLPUINT32 .

Un descripteur smiOCTETS ou un descripteur smiOID peut être le membre de valeur d’une structure smiVALUE . La structure smiVALUE décrit la valeur associée à un nom de variable dans une entrée de liaison de variable.

L’implémentation de Microsoft WinSNMP alloue et libère la mémoire pour toutes les structures smiOCTETS et smiOID de sortie. Par conséquent, l’application doit appeler la fonction SnmpFreeDescriptor pour libérer la mémoire du membre ptr de ces structures.

Les membres de chaîne dans les descripteurs n’ont pas besoin d’un octet de fin NULL . Pour plus d’informations sur la gestion de la mémoire allouée pour les descripteurs, consultez Allocation d’objets de mémoire WinSNMP.