INATEventManager::put_NumberOfEntriesCallback method (natupnp.h)

The put_NumberOfEntriesCallback method enables the NAT application with UPnP technology to register a callback interface with the NAT. The system calls the first method in this callback interface if the number of NAT port mappings changes.

Syntax

HRESULT put_NumberOfEntriesCallback(
  [in] IUnknown *pUnk
);

Parameters

[in] pUnk

Pointer to an object that supports either the IUnknown interface or the IDispatch interface. See the Remarks section for more information.

Return value

If the method succeeds the return value is S_OK.

If the method fails, the return value is one of the following error codes.

Remarks

The object referred to by pUnk must either support the INATNumberOfEntriesCallback interface or the IDispatch interface. The NAT first queries pUnk for the INATNumberOfEntriesCallback interface. If this interface is not supported, the NAT queries pUnk for the IDispatch interface. If the IDispatch interface is not supported, the NumberOfEntriesCallback method returns E_FAIL.

If only IDispatch is supported, the NAT invokes the callback by calling IDispatch::Invoke with the dispatch ID specified as zero, which indicates the default method. This IDispatch method is passed the same parameters as the INATNumberOfEntriesCallback method, except that the first parameter passed is a string that indicates the reason the callback is invoked.

Requirements

See also

IDispatch

INATEventManager

INATNumberOfEntriesCallback

Network Address Translation Traversal Interfaces

Network Address Translation Traversal Reference