INATNumberOfEntriesCallback::NewNumberOfEntries method (natupnp.h)

The system calls the NewNumberOfEntries method if the total number of NAT port mappings changes.

Syntax

HRESULT NewNumberOfEntries(
  [in] long lNewNumberOfEntries
);

Parameters

[in] lNewNumberOfEntries

Specifies a long variable that contains the new number of port mappings.

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.

Return code Description
E_ABORT
The operation was aborted.
E_FAIL
An unspecified error occurred.
E_INVALIDARG
One of the parameters is invalid.
E_NOINTERFACE
A specified interface is not supported.
E_NOTIMPL
A specified method is not implemented.
E_OUTOFMEMORY
The method was unable to allocate required memory.
E_POINTER
A pointer passed as a parameter is not valid.
E_UNEXPECTED
The method failed for unknown reasons.

Remarks

The system calls this method when the total number of port mappings changes. The change in the total number of port mappings may be the result of a change in the number of dynamic port mappings. In this case, the system calls this method even though the number of static port mappings has not changed.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header natupnp.h
DLL Hnetcfg.dll

See also

INATEventManager::put_NumberOfEntriesCallback

INATNumberOfEntriesCallback

IStaticPortMappingCollection::get_Count

Network Address Translation Traversal Interfaces

Network Address Translation Traversal Reference