On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

WNetCancelConnection

The WNetCancelConnection function breaks an existing network connection.

The function is provided for compatibility with earlier versions of Microsoft Windows. For new applications, use the WNetCancelConnection2 function.

DWORD WNetCancelConnection(

LPTSTR lpName, // pointer to resource name to be disconnected
BOOL fForce // flag for unconditional disconnect
);

Parameters

lpName

Points to a null-terminated string that specifies the name of either the redirected local device or the remote network resource to disconnect from. When this parameter specifies a redirected local device, only the specified device redirection is broken. If the parameter specifies a remote network resource, only the connections to remote networks without devices are broken.

fForce

Specifies whether the disconnection is to occur even if there are open files or jobs on the connection. If this parameter is FALSE, the function fails if there are open files or jobs.

Return Values

If the function succeeds, the return value is NO_ERROR.
If the function fails, the return value is an error code. To get extended error information, call GetLastError. GetLastError may return one of the following error codes:

Value Meaning
ERROR_BAD_PROFILE The user profile is in an incorrect format.
ERROR_CANNOT_OPEN_PROFILE The system is unable to open the user profile to process persistent connections.
ERROR_DEVICE_IN_USE The device is in use by an active process and cannot be disconnected.
ERROR_EXTENDED_ERROR A network-specific error occurred. To get a description of the error, use the WNetGetLastError function.
ERROR_NOT_CONNECTED The name specified by the lpName parameter is not a redirected device, or the system is not currently connected to the device specified by the parameter.
ERROR_OPEN_FILES There are open files, and the fForce parameter is FALSE.

The function returns error codes for compatibility with Windows version 3.1. For compatibility with the Win32 API, the function also sets the error code value returned by GetLastError.

See Also

WNetAddConnection, WNetAddConnection2, WNetCancelConnection2, WNetGetConnection, WNetGetLastError

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

WNetCancelConnection

Функция WNetCancelConnection ломает существующую сетевую связь.

Функция предусмотрена для совместимости более ранними версиями Microsoft Windows. Для новых приложений, используйте функцию WNetCancelConnection2.

DWORD WNetCancelConnection(

LPTSTR lpName, // УКАЗАТЕЛЬ в имя ресурса, чтобы быть разъединивш флаг BOOL fForce // для безусловного разъединяться
);

Параметры

lpName

Точки на недействительный расторгнутую строку, которые определяют имя или переназначенное локальное устройство или дистанционный сетевой ресурс, чтобы разъединять из. Когда этот параметр определяет переназначенное локальное устройство, только определенная переадресация устройства прервана. Если параметр определяет дистанционный сетевой ресурс, только связи в дистанционные сети без устройств прерваны.

fForce

Определяет должно разъединение происходить даже если бы есть открытые файлы или рабочие места на связи. Если этот параметр является ЛОЖЬЮ, функция терпит неудачу если есть открытые файлы или рабочие места.

Обратные Величины

Если функция добивается успеха, обратная величина - NO_ERROR.
Если функция терпит неудачу, обратная величина является кодом ошибки. Для того, чтобы расширять информацию ошибки, назовите GetLastError. GetLastError МОЖЕТ возвращать один из следующих кодов ошибки:

Значение Величины
ERROR_BAD_PROFILE профиль пользователя - в неправильном формате.
ERROR_CANNOT_OPEN_PROFILE система - не в состоянии открыть профиль пользователя, чтобы обрабатывать устойчивые связи.
ERROR_DEVICE_IN_USE устройство используется активным процессом и не мочь быть разъединено.
ERROR_EXTENDED_ERROR сетевая-специфическая ошибка происходила. Для того, чтобы получать описание ошибки, используйте функцию WNetGetLastError.
ERROR_NOT_CONNECTED имя определенное параметром lpName - не переназначенное устройство, или система к настоящему времени не подключена к устройству определенному параметром.
ERROR_OPEN_FILES Есть открытые файлы, и параметр fForce ЛОЖНЫЙ.

Функция возвращает коды ошибки для совместимости с версией Windows 3.1. Для совместимости с Win32 API, функция также устанавливает кодовую величину ошибки возвращанную GetLastError.

Смотри Также

WNetAddConnection, WNetAddConnection2, WNetCancelConnection2, WNetGetConnection, WNetGetLastError

Используются технологии uCoz