Функция WNetAddConnectionA (winnetwk.h)
Функция WNetAddConnection позволяет вызывающему приложению подключать локальное устройство к сетевому ресурсу. Успешное подключение является постоянным, что означает, что система автоматически восстанавливает подключение во время последующих операций входа.
Синтаксис
DWORD WNetAddConnectionA(
[in] LPCSTR lpRemoteName,
[in] LPCSTR lpPassword,
[in] LPCSTR lpLocalName
);
Параметры
[in] lpRemoteName
Указатель на константную строку, завершающуюся значением NULL, которая указывает сетевой ресурс для подключения.
[in] lpPassword
Указатель на константную строку, завершающуюся значением NULL, которая указывает пароль, используемый для подключения. Этот параметр обычно является паролем, связанным с текущим пользователем.
Если этот параметр имеет значение NULL, используется пароль по умолчанию. Если строка пуста, пароль не используется.
Windows Me/98/95: Этот параметр должен иметь значение NULL или пустую строку.
[in] lpLocalName
Указатель на константную строку со значением NULL, указывающую имя перенаправляемого локального устройства, например "F:" или "LPT1". Строка обрабатывается без учета регистра. Если строка имеет значение NULL, подключение к сетевому ресурсу осуществляется без перенаправления локального устройства.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.
Если функция завершается сбоем, возвращаемое значение представляет собой системный код ошибки, например одно из следующих значений.
Код возврата | Описание |
---|---|
|
Вызывающий объект не имеет доступа к сетевому ресурсу. |
|
Устройство, указанное в параметре lpLocalName , уже подключено. |
|
Тип устройства и тип ресурса не совпадают. |
|
Недопустимое значение, указанное в параметре lpLocalName . |
|
Значение, указанное в параметре lpRemoteName , является недопустимым или не может быть найдено. |
|
Профиль пользователя имеет неправильный формат. |
|
Системе не удается открыть профиль пользователя для обработки постоянных подключений. |
|
Запись для устройства, указанного в параметре lpLocalName , уже находится в профиле пользователя. |
|
Произошла ошибка, относявшаяся к сети. Чтобы получить описание ошибки, вызовите функцию WNetGetLastError . |
|
Указанный пароль недопустим. |
|
Невозможно выполнить операцию, так как не запущен сетевой компонент или невозможно использовать указанное имя. |
|
Сеть недоступна. |
Комментарии
В Windows Server 2003 и Windows XP функции WNet создают и удаляют буквы сетевых дисков в пространстве имен устройств MS-DOS, связанном с сеансом входа, так как устройства MS-DOS идентифицируются с помощью AuthenticationID (a).
локально уникальный идентификатор или LUID, связанный с сеансом входа.) Это может повлиять на приложения, которые вызывают одну из функций WNet для создания буквы сетевого диска при входе одного пользователя, но запрашивают существующие буквы сетевых дисков при входе другого пользователя. Примером такой ситуации может быть создание второго входа пользователя в сеансе входа, например путем вызова функции CreateProcessAsUser , а при втором входе запускается приложение, которое вызывает функцию GetLogicalDrives . Вызов функции GetLogicalDrives не возвращает буквы сетевых дисков, созданные вызовами функции WNet при первом входе в систему. Обратите внимание, что в предыдущем примере первый сеанс входа по-прежнему существует, и этот пример может применяться к любому сеансу входа, включая сеанс служб терминалов. Дополнительные сведения см. в разделе Определение имени устройства MS-DOS.
Если в Windows Server 2003 и Windows XP служба, которая выполняется как LocalSystem, вызывает функцию WNetAddConnection , сопоставленный диск будет виден всем сеансам входа пользователей.
Примечание
Заголовок winnetwk.h определяет WNetAddConnection как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | winnetwk.h |
Библиотека | Mpr.lib |
DLL | Mpr.dll |