Format
struct dpi_next_packet {
char *object_p; /* ptr to OID (string) */
char *group_p; /* ptr to subtree(group)*/
char *instance_p;/* ptr to rest of OID */
struct dpi_next_packet *next_p; /* ptr to next in chain */
};
typedef struct dpi_next_packet snmp_dpi_next_packet;
#define snmp_dpi_next_packet_NULL_p ((snmp_dpi_next_packet *)0)
Parameters
- object_p
- A pointer to a null-terminated character string that represents
the full object identifier of the variable instance that is being
accessed. It basically is a concatenation of the fields group_p and instance_p. Using this field is not recommended because
it is included only for DPI Version 1 compatibility and it might be withdrawn
in a later version.
- group_p
- A pointer to a null-terminated character string that represents
the registered subtree that caused this GETNEXT request to be passed
to this DPI subagent. This subtree must have a trailing period.
- instance_p
- A pointer to a null-terminated character string that represents
the rest, which is the piece that follows the subtree part, of the
object identifier of the variable instance being accessed.
Use
of the term instance_p here must not be confused with an OBJECT
instance because this string might consist of a piece of the object
identifier plus the INSTANCE IDENTIFIER.
- next_p
- A pointer to a possible next snmp_dpi_next_packet structure.
If this next field contains the NULL pointer, this is the end of the
chain.
Usage
The snmp_dpi_next_packet structure
represents a parse tree for a DPI GETNEXT packet.
At the subagent side,
the snmp_dpi_next_packet structure is normally created as a result
of a call to pDPIpacket(). This is the case if the DPI packet is of type SNMP_DPI_GETNEXT.
The snmp_dpi_hdr structure then contains a pointer to a chain of
one or more snmp_dpi_next_packet structures.
The DPI subagent programmer
uses this structure to find out which variables instances are to be
returned in a DPI RESPONSE.