IOCTL_SERVICE_NOTIFY_ADDR_CHANGE

  • Article

This IOCTL is passed as an input parameter along when Services.exe notifies every running service of address changes in the system.

Parameters

  • pBufIn
    [in] Pointer to a PIP_ADAPTER_INFO structure containing information on the local addresses for a specific network adapter.

Return Values

Returns TRUE if successful, FALSE otherwise. To obtain extended error information, call the SetLastError function.

Remarks

When Services.exe initializes, it creates a thread that receives notification on address changes in the system. When an IP address on the system is added or removed, this thread wakes up and calls the GetAdaptersAddresses function to retrieve the information on the local addresses. It then calls every running service with IOCTL_SERVICE_NOTIFY_ADDR_CHANGE and with the results of GetAdaptersAddresses in the input parameters.

If a service needs to use this information later, it should make its own copy of the data. The pointer passed to the service during the call to the xxx_IOControl function is guaranteed to be valid only during the duration of the function call.

Requirements

OS Versions: Windows CE .NET 4.1 and later.
Header: Service.h.

See Also

xxx_IOControl | GetAdaptersAddresses

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.