INATExternalIPAddressCallback::NewExternalIPAddress method (natupnp.h)
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 |
|---|---|
|
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
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 |
See also
INATEventManager::put_ExternalIPAddressCallback