AddConnectNotify function (npapi.h)

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.

Syntax

DWORD AddConnectNotify(
  [in, out] LPNOTIFYINFO lpNotifyInfo,
  [in]      LPNOTIFYADD  lpAddInfo
);

Parameters

[in, out] lpNotifyInfo

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

[in] lpAddInfo

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.

Remarks

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.

Requirements

See also

CancelConnectNotify