AddConnectNotify function

The AddConnectNotify function is called before and after each add connection operation (WNetAddConnection, WNetAddConnection2, and WNetAddConnection3) is attempted by the Multiple Provider Router (MPR).

The AddConnectNotify function is not called when MPR is automatically restoring network connections.


DWORD APIENTRY AddConnectNotify(
  _Inout_ LPNOTIFYINFO lpNotifyInfo,
  _In_    LPNOTIFYADD  lpAddInfo


lpNotifyInfo [in, out]

A pointer to a NOTIFYINFO structure that contains information about the notification.

lpAddInfo [in]

A pointer to a NOTIFYADD structure that contains information about the connection being added.

Return value

If the function succeeds, the function should return WN_SUCCESS.

If the function fails, it should return an error code. This can be any of the error codes specified in Network Security Return Values.


The AddConnectNotify function is implemented by applications that need to receive notification from the MPR when a network resource is connected or disconnected. For more information about how to write an application that receives such notifications, see Receiving Connection Notifications.


Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]



See also