SnmpExtensionInitEx function (snmp.h)

[SNMP is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use Windows Remote Management, which is the Microsoft implementation of WS-Man.]

The Microsoft SNMP service calls the SnmpExtensionInitEx function 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 SNMP_FUNC_TYPE SnmpExtensionInitEx(
  [out] AsnObjectIdentifier *pNextSupportedRegion
);

Parameters

[out] pNextSupportedRegion

Pointer to an AsnObjectIdentifier structure to receive the next MIB subtree that the extension agent supports.

Return value

If the pNextSupportedRegion parameter 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 SnmpExtensionInitEx function entry point so the extension agent can register support for additional MIB subtrees.

The SNMP service makes a copy of the AsnObjectIdentifier structure the extension agent returns in the pNextSupportedRegion parameter. The extension agent must allocate and deallocate the resources associated with the original structure. It can do this when the SNMP service calls the SnmpExtensionClose function.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header snmp.h

See also

AsnObjectIdentifier

SNMP Functions

Simple Network Management Protocol (SNMP) Overview

SnmpExtensionClose

SnmpExtensionInit

SnmpExtensionMonitor