WNetDisconnectDialog1A function (winnetwk.h)
The WNetDisconnectDialog1 function attempts to disconnect a network resource. If the underlying network returns ERROR_OPEN_FILES, the function prompts the user for confirmation. If there is any error, the function informs the user. The function requires a DISCDLGSTRUCT to specify the parameters for the disconnect attempt.
Syntax
DWORD WNetDisconnectDialog1A(
[in] LPDISCDLGSTRUCTA lpConnDlgStruct
);
Parameters
[in] lpConnDlgStruct
Pointer to a DISCDLGSTRUCT structure. The structure specifies the behavior for the disconnect attempt.
Return value
If the function succeeds, the return value is NO_ERROR. If the user cancels the dialog box, the return value is –1.
If the function fails, the return value is a system error code, such as one of the following values.
| Return code | Description |
|---|---|
|
When the system prompted the user for a decision about disconnecting, the user elected not to disconnect. |
|
Unable to disconnect because the user is actively using the connection. |
|
The network provider is busy (possibly initializing). The caller should retry. |
|
The network is unavailable. |
|
There is insufficient memory to start the dialog box. |
|
A network-specific error occurred. Call the WNetGetLastError function to obtain a description of the error. |
Remarks
Note
The winnetwk.h header defines WNetDisconnectDialog1 as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | winnetwk.h |
| Library | Mpr.lib |
| DLL | Mpr.dll |