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 is called by the Microsoft SNMP service to identify any additional management information base (MIB) subtrees the SNMP extension agent supports. This function is an element of the SNMP Extension Agent API.

Syntax 


BOOL SnmpExtensionInitEx(
  AsnObjectIdentifier*
 pNextSupportedRegion 

);

Parameters

pNextSupportedRegion

[out] Pointer to an AsnObjectIdentifierstructure to receive the next MIB subtree that the extension agent supports.

Return Value

If the pNextSupportedRegionparameter has been initialized with an additional MIB subtree, the return value is TRUE.

If there are no more MIB subtrees to register, the return value is FALSE.

Remarks

The SNMP service repeatedly calls the SnmpExtensionInitExfunction entry point so the extension agent can register support for additional MIB subtrees.

The SNMP service makes a copy of the AsnObjectIdentifierstructure the extension agent returns in the pNextSupportedRegionparameter. The extension agent must allocate and deallocate the resources associated with the original structure. It can do this when the SNMP service calls the SnmpExtensionClosefunction.

If there are two agents with the same region, the first one in the list has priority. If that query happens to return nosuchname, then the first agent will continue down the list and the second agent can attempt the query. The list of regions in the registry is determined by the order in which the subagents are loaded. Typically overlapping subagents are not a problem; when it does occur, the one listed earlier in the registry has higher precedence.

Requirements

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

See Also