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 |
---|---|
|
The operation was aborted. |
|
An unspecified error occurred. |
|
One of the parameters is invalid. |
|
A specified interface is not supported. |
|
A specified method is not implemented. |
|
The method was unable to allocate required memory. |
|
A pointer passed as a parameter is not valid. |
|
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
IStaticPortMappingCollection::get_Count