Platform SDK: Network Management

AsnOctetString

The AsnOctetString structure contains octet quantities, usually bytes. This structure is used by multiple SNMP functions. This structure is not used by the WinSNMP API functions.

typedef struct { 
    BYTE  * stream;  // pointer to octet stream
    UINT  length;    // number of octets in stream
    BOOL  dynamic;   // dynamic allocation flag
} AsnOctetString;

Members

stream
Pointer to the octet stream.
length
The number of octets in the data stream.
dynamic
Flag that specifies whether the data stream has been dynamically allocated with the SnmpUtilMemAlloc function.

Remarks

Use the AsnOctetString structure to transfer string values. For example, use it to transfer the string that represents a computer name as a MIB object value.

You must check the flag specified in the dynamic member before you release the data stream of an octet string. Call the SnmpUtilMemFree function only if the dynamic member is set to TRUE.

Requirements

  Windows NT/2000: Requires Windows NT 3.51 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Snmp.h.

See Also

Simple Network Management Protocol (SNMP) Overview, SNMP Structures, SnmpUtilMemFree, SnmpUtilMemAlloc