Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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