Edit

Share via

NOTIFYCANCEL structure (npapi.h)

  • Article

The NOTIFYCANCEL structure contains the details of a network disconnect operation. It is used by the CancelConnectNotify function.

Syntax

typedef struct _NOTIFYCANCEL {
  LPWSTR lpName;
  LPWSTR lpProvider;
  DWORD  dwFlags;
  BOOL   fForce;
} NOTIFYCANCEL, *LPNOTIFYCANCEL;

Members

lpName

Pointer to the name of the local device or network resource whose connection is being canceled.

lpProvider

For advance notification, this field is not defined. The MPR will try all valid providers to cancel the connection.

For after-the-fact notification, if the cancel operation was successful, this field specifies the name of the network provider that canceled the connection.

dwFlags

Currently, the only flag supported is CONNECT_UPDATE_PROFILE, which indicates whether the disconnection should remain persistent. If this flag is set, Windows no longer restores this connection when the user logs on.

fForce

Indicates whether the disconnect should continue even if there are open files or jobs on the connection. If this field is TRUE, the connection is canceled regardless of open files or jobs. If this field is FALSE, the connection will not be canceled if there are open files or jobs.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header npapi.h