SnmpUtilOidAppend

The SnmpUtilOidAppend function appends the source object identifier to the destination object identifier. This function is an element of the SNMP Utility API. 

SNMPAPI SnmpUtilOidAppend(
  AsnObjectIdentifier *pOidDst,  // destination object identifier
  AsnObjectIdentifier *pOidSrc   // source object identifier
);

Parameters

pOidDst
[in/out] Pointer to an AsnObjectIdentifier structure to receive the source structure.
pOidSrc
[in] Pointer to an AsnObjectIdentifier structure to append.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. This function does not generate Windows Sockets errors. The application should call the GetLastError function. GetLastError may return the following error codes.

Error Code Description
SNMP_BERAPI_OVERFLOW Indicates an overflow condition
SNMP_MEM_ALLOC_ERROR Indicates a memory allocation error

Remarks

The SnmpUtilOidAppend function calls the SnmpUtilMemReAlloc function. The SnmpUtilMemReAlloc function expands the buffer for the destination object identifier.

Call the SnmpUtilOidFree function to free memory that the SnmpUtilOidAppend function allocates for the destination.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in snmp.h.
  Import Library: Use snmpapi.lib.

See Also

Simple Network Management Protocol (SNMP) Overview, SNMP Functions, SnmpUtilMemReAlloc, SnmpUtilOidFree