- SNMP_MGR_RC_OK if successful
- SNMP_MGR_RC_NULL_PTR if this function's snmpSession,
pdu, or decodedResponse parameter
value is NULL
- SNMP_MGR_RC_TIMEOUT if there is a timeout while waiting for a
response from the target agent
- SNMP_MGR_RC_IO_ERROR if there is an error while waiting for a
response from the target agent that is not the result of a timeout
- SNMP_MGR_RC_INVALID_PARAMETERS if the waitInterval parameter value is less than 0 or if the receiveOnly parameter value is not 0 or 1
- SNMP_MGR_RC_ENCODE_ERROR if an error was encountered while encoding
a PDU. If your SNMP manager sends an SNMPv3 request to a target agent
without the agent's engineID value, this
function handles the receipt of the agent's report PDU. In doing
so, a new request PDU is built and is sent to the target agent, using
the agent's engineID value.
- 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, including the internal return code value. Your IBM® service representative uses
this internal return code to help solve your error.
- SNMP_MGR_RC_USM_UNKNOWN_USERNAME if the target agent responded
with a report PDU, indicating that a user name that was not valid
was sent in your request
- SNMP_MGR_RC_USM_UNSUPPORTED_SECLEVEL if the target agent responded
with a report PDU, indicating that a security level that was not valid
was sent in your request
- SNMP_MGR_RC_USM_WRONG_DIGEST if the target agent responded with
a report PDU, indicating that the message digest (created with the
authentication key you defined) is not valid
- SNMP_MGR_RC_USM_NOT_IN_WINDOW if the target agent responded with
a report PDU, indicating that your request did not fall within the
target agent's accepted time range
- SNMP_MGR_RC_USM_DECRYPTION_ERROR if the target agent responded
with a report PDU, indicating that the target agent could not successfully
decrypt your encrypted request
Rule: Because this function
requires an SNMP session and an SNMP PDU as input parameters, your
SNMP manager must call the snmpBuildSession() and snmpBuildPDU() functions
before calling this function. Your SNMP manager is responsible for
allocating storage for the response PDU. After you are finished using
this PDU, ensure that you free its storage.