snmp_pdu_create()

Create an SNMP message structure

Synopsis:

#include <sys/types.h>
#include <netinet/in.h>
#include <snmp/snmp.h>
#include <snmp/asn1.h>
#include <snmp/snmp_api.h>
#include <snmp/snmp_client.h>

struct snmp_pdu * snmp_pdu_create (int command );

Library:

snmp3r.lib, snmp3s.lib

Description:

The snmp_pdu_create() function allocates memory for a Protocol Data Unit (PDU) structure for SNMP message passing. The command argument specifies the type of message that the PDU represents:

BULK_REQ_MSG
GET_REQ_MSG
GET_RSP_MSG
GETNEXT_REQ_MSG
INFORM_REQ_MSG
SET_REQ_MSG
TRP_REQ_MSG
TRP2_REQ_MSG

as defined in <snmp/snmp.h>. The PDU structure is initialized with default values; see snmp_pdu in this chapter.

Returns:

A pointer to the PDU structure created, or NULL if an error occurs (snmp_errno is set).

Errors:

SNMPERR_GENERR: Not enough memory to create the snmp_pdu structure.

Classification:

SNMP

Safety:
Interrupt handler	No
Signal handler	No
Thread	No