Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Other versions of this page are also available for the following:
Windows Mobile Not Supported Windows Embedded CE Supported
8/28/2008

This function appends the source object identifier to the destination object identifier.

Syntax 


SNMPAPI SnmpUtilOidAppend(
  AsnObjectIdentifier* 
pOidDst
, 
  AsnObjectIdentifier* 
pOidSrc
 
);

Parameters

pOidDst

[in, out] Pointer to an AsnObjectIdentifierstructure to receive the source structure.

pOidSrc

[in] Pointer to an AsnObjectIdentifierstructure to append.

Return Value

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 GetLastErrorfunction. GetLastErrormay return the following error codes.

Value Description

SNMP_BERAPI_OVERFLOW

Indicates an overflow condition.

SNMP_MEM_ALLOC_ERROR

Indicates a memory allocation error.

Remarks

The SnmpUtilOidAppendfunction calls the SnmpUtilMemReAllocfunction. The SnmpUtilMemReAllocfunction expands the buffer for the destination object identifier.

Call the SnmpUtilOidFreefunction to free memory that the SnmpUtilOidAppendfunction allocates for the destination.

Requirements

Header snmp.h
Library snmpapi.lib
Windows Embedded CE Windows CE 3.0 and later

See Also