NotifyAddrChange

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function causes a notification to be sent to the caller whenever a change occurs in the table that maps IP addresses to interfaces.

Syntax

DWORD NotifyAddrChange(
  PHANDLE Handle, 
  LPOVERLAPPED overlapped 
);

Parameters

• Handle
  [in] Pointer to a handle to use in asynchronous notification. The application should close this handle by calling the CloseHandle function when it is finished listening for events.

• overlapped
  [in] Not supported in Windows Embedded CE.

Return Value

Returns NO_ERROR if successful. If the function fails, it returns an error code. For a complete list of error codes, see Error Values or the SDK header file Winerror.h.

Remarks

If the application specifies NULL for the Handle parameter, the call to this function blocks until an IP address change occurs. The application must call CloseHandle on the retrieved handle when it is no longer needed.

The returned event is pulsed, not set, thus the application has to call WaitForSingleObject after it calls NotifyAddrChange in order to be waiting when the address changes. The application cannot wait for this event and expect it to be in set state after the address changed.

Requirements

See Also

Reference

IP Helper Functions
NotifyRouteChange