Prev Next

WNetDisconnectDialog1 info Overview Group

The WNetDisconnectDialog1 function attempts to disconnect from a network resource. If the underlying network returns WN_OPEN_FILES, the function prompts the user for confirmation. If there is any error, it informs the user.

DWORD WNetDisconnectDialog1(

LPDISCDLGSTRUCT lpDiscDlgStruc

// pointer to structure

);

Parameters

lpDiscDlgStruct: Pointer to the DISCDLGSTRUCT data structure, which specifies the behavior for the disconnect attempt.

Return Values

WN_SUCCESS if the connection is successfully disconnected. Error codes include the following.

Value

Meaning

WN_CANCEL

After the user was prompted for a decision to disconnect, the user elected not to disconnect.

WN_OPEN_FILES

Unable to disconnect because the user is actively using the connection.

WN_FUNCTION_BUSY

The MPR or NP is busy (possibly initializing). The caller should retry. [The terms MPR and NP shouldn’t appear in these docs, as we discussed once in email.]

WN_NO_NETWORK

The network is not present.

WN_OUT_OF_MEMORY

There is not enough memory to bring up the dialog.

WN_EXTENDED_ERROR

A network specific error occurred. Call WNetGetLastError to obtain a description of the error.

LPDISCDLGSTRUCT lpDiscDlgStruc	// pointer to structure
);

Value	Meaning
WN_CANCEL	After the user was prompted for a decision to disconnect, the user elected not to disconnect.
WN_OPEN_FILES	Unable to disconnect because the user is actively using the connection.
WN_FUNCTION_BUSY	The MPR or NP is busy (possibly initializing). The caller should retry. [The terms MPR and NP shouldn’t appear in these docs, as we discussed once in email.]
WN_NO_NETWORK	The network is not present.
WN_OUT_OF_MEMORY	There is not enough memory to bring up the dialog.
WN_EXTENDED_ERROR	A network specific error occurred. Call WNetGetLastError to obtain a description of the error.

WNetDisconnectDialog1 info Overview Group

Parameters

Return Values

See Also