snmpBuildSession result

SNMP_MGR_RC_OK if successful.
SNMP_MGR_RC_NULL_PTR if the configEntry or snmpSession parameter of this function is NULL.
SNMP_MGR_RC_SOCK_ERROR if there was an error encountered when opening the socket, setting the socket to be non-blocking, or attempting to bind the socket to a local address or port.
SNMP_MGR_RC_OUT_OF_MEMORY if storage for the session could not be allocated.
SNMP_MGR_RC_INVALID PARAMETERS if the cfgLen or cfgVersion field of the configEntry parameter does not match the required value, as defined in the SNMP Manager API header file, <snmpmgr.h>.
SNMP_MGR_RC_INTERNAL_ERROR if an error occurred in an internal function. See your SNMP manager API log file for more information about the error and the internal return code value. Your IBM® service representative uses this internal return code to help solve your error.

Rule: Typically, you should call the snmpInitialize() function before you call this function, because the SnmpConfigEntry input parameter is returned from the snmpInitialize() function. However, alternatively you can manually create an SnmpConfigEntry structure. After you are finished with the SNMP session returned by this function, you must close the socket and free the storage that was allocated by calling the snmpTerminateSession() function.