The DPIconnect_to_agent_TCP() Function

Syntax

#include <snmp_dpi.h>

int DPIconnect_to_agent_TCP(    /* Connect to DPI TCP port    */
  char          *hostname_p,    /* target hostname/IP address */
  char          *community_p);  /* community name             */

Parameters

hostname_p

A pointer to a NULL terminated character string representing the host name or IP address in dot notation of the host where the DPI capable SNMP agent is running.
community_p
A pointer to a NULL terminated character string representing the community name that is required to obtain the dpiPort from the SNMP agent via an SNMP GET request.

Return Values

If successful, a positive integer that represents the connection is returned. It is to be used as a handle in subsequent calls to DPI transport-related functions.

If failure, a negative integer is returned. It indicates the kind of error that occurred. See Return Codes from DPI Transport-Related Functions for a list of possible error codes.

Description

The DPIconnect_to_agent_TCP() function is used at the subagent side to setup a TCP connection to the DPI capable SNMP agent.

Examples

  #include <snmp_dpi.h>  int                  handle;

  handle = DPIconnect_to_agent_TCP("localhost", "loopback");
  if (handle < 0) {
     printf("Error %d from connect\n",handle);
     exit(1);
  } /* endif */

Related Information

Return Codes from DPI Transport-Related Functions
The DPIconnect_to_agent_SHM() Function

---

[Back: The DPIconnect_to_agent_SHM() Function]
[Next: The DPIdisconnect_from_agent() Function]