Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

Use the following functions to ensure that an application receives notification of certain network events.

Note:
These functions block the application until notification is received.

The NotifyAddrChangefunction enables an application to request notification of any change that occurs in the table that maps IP addresses to interfaces on the local computer.

Similarly, the NotifyRouteChangefunction enables an application to request notification of any change that occurs in the IP routing table.

The notifications provided by these functions do not specify what changed. They simply specify that something changed. Use other IP Helper functions to determine the exact nature of the change.

The following table describes each NotifyAddrChangevariable and OVERLAPPEDmember.

Value Description

Handle

Pointer to a HANDLE variable that receives a handle to use in asynchronous notification.

overlapped

Pointer to an OVERLAPPEDstructure that will notify the caller of any changes in the table that maps IP addresses to interfaces.

OVERLAPPED (structure)

InternalHigh

Note:
Reserved for operating system use. This member, which specifies the length of the data transferred, is valid when the GetOverlappedResultfunction returns TRUE.

Offset

Note:
Specifies a file position at which to start the transfer. The file position is a byte offset from the start of the file. The calling process sets this member before calling the ReadFileor WriteFilefunction.

OffsetHigh

Note:
Specifies the high word of the byte offset at which to start the transfer.

hEvent

Note:
Handle to an event set to the signaled state when the operation has been completed. The calling process must set this member either to zero or a valid event handle before calling any overlapped functions. To create an event object, use the CreateEventfunction.

The following table describes each NotifyRouteChangevariable.

Value Description

Handle

Pointer to a HANDLE variable that receives a handle to use in asynchronous notification.

overlapped

Pointer to an OVERLAPPEDstructure that will notify the caller of any changes in the routing table. (See the NotifyAddrChangedescription above).

See Also