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.
DWORD WNetDisconnectDialog1A( LPDISCDLGSTRUCTA lpConnDlgStruct );
Pointer to a DISCDLGSTRUCT structure. The structure specifies the behavior for the disconnect attempt.
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.
||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.|
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|