INATExternalIPAddressCallback::NewExternalIPAddress method (natupnp.h)

Article
02/22/2024

The system calls the NewExternalIPAddress method if the external IP address of the NAT computer changes.

Syntax

HRESULT NewExternalIPAddress(
  [in] BSTR bstrNewExternalIPAddress
);

Parameters

[in] bstrNewExternalIPAddress

Specifies a BSTR variable that contains the new external IP address.

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

One reason why the external IP address of the NAT computer could change would be the IP address is allocated through DHCP, and the DHCP lease expired.

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