Функция WNetUseConnectionA (winnetwk.h)

Функция WNetUseConnection устанавливает подключение к сетевому ресурсу. Функция может перенаправлять локальное устройство в сетевой ресурс.

Функция WNetUseConnection аналогична функции WNetAddConnection3 . Разница main заключается в том, что WNetUseConnection может автоматически выбрать неиспользуемое локальное устройство для перенаправления на сетевой ресурс.

Синтаксис

DWORD WNetUseConnectionA(
  [in]      HWND           hwndOwner,
  [in]      LPNETRESOURCEA lpNetResource,
  [in]      LPCSTR         lpPassword,
  [in]      LPCSTR         lpUserId,
  [in]      DWORD          dwFlags,
  [out]     LPSTR          lpAccessName,
  [in, out] LPDWORD        lpBufferSize,
  [out]     LPDWORD        lpResult
);

Параметры

[in] hwndOwner

Обработка окна, которое поставщик сетевых ресурсов может использовать в качестве окна владельца для диалоговых окон. Используйте этот параметр, если вы задали значение CONNECT_INTERACTIVE в параметре dwFlags .

[in] lpNetResource

Указатель на структуру NETRESOURCE , которая указывает сведения о предполагаемом подключении. Структура содержит сведения о сетевом ресурсе, локальном устройстве и поставщике сетевых ресурсов.

Необходимо указать следующие элементы структуры NETRESOURCE .

Функция WNetUseConnection игнорирует другие элементы структуры NETRESOURCE . Дополнительные сведения см. в следующих описаниях для параметра dwFlags .

[in] lpPassword

Указатель на константную строку, завершающуюся значением NULL, которая указывает пароль, используемый при подключении к сети.

Если lpPassword имеет значение NULL, функция использует текущий пароль по умолчанию, связанный с пользователем, указанным в lpUserID.

Если lpPassword указывает на пустую строку, функция не использует пароль.

Если подключение завершается сбоем из-за недопустимого пароля и в параметре dwFlags задано значение CONNECT_INTERACTIVE, функция отображает диалоговое окно с запросом на ввод пароля.

[in] lpUserId

Указатель на константную строку, завершающуюся значением NULL, которая указывает имя пользователя для соединения.

Если lpUserID имеет значение NULL, функция использует имя пользователя по умолчанию. (Контекст пользователя для процесса предоставляет имя пользователя по умолчанию.)

Параметр lpUserID указывается, когда пользователи хотят подключиться к сетевому ресурсу, для которого им назначено имя пользователя или учетная запись, отличные от имени пользователя или учетной записи по умолчанию.

Строка имени пользователя представляет контекст безопасности. Он может быть специфичным для сетевого поставщика.

[in] dwFlags

Набор битовых флагов, описывающих подключение. Этот параметр может быть любым сочетанием следующих значений.

[out] lpAccessName

Указатель на буфер, который получает системные запросы к подключению. Этот параметр может принимать значение NULL.

Если этот параметр указан, а элемент lpLocalName структуры NETRESOURCE указывает локальное устройство, этот буфер получает имя локального устройства. Если lpLocalName не указывает устройство и сеть требует перенаправления локального устройства или если задано значение CONNECT_REDIRECT, этот буфер получает имя перенаправленного локального устройства.

В противном случае в буфер копируется имя удаленного ресурса. Если этот буфер указан, размер этого буфера должен быть не меньше строки, на которую указывает элемент lpRemoteName .

[in, out] lpBufferSize

Указатель на переменную, указывающую размер буфера lpAccessName в символах. Если вызов завершается сбоем из-за недостаточно большого размера буфера, функция возвращает требуемый размер буфера в этом расположении. Дополнительные сведения см. в описании параметра lpAccessName и коде ошибки ERROR_MORE_DATA в разделе Возвращаемые значения.

[out] lpResult

Указатель на переменную, которая получает дополнительные сведения о подключении. Этот параметр может иметь следующее значение.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращаемое значение представляет собой системный код ошибки, например одно из следующих значений.

Комментарии

Windows Server 2003 и Windows XP: Функции WNet создают и удаляют буквы сетевых дисков в пространстве имен устройств MS-DOS, связанном с сеансом входа, так как устройства MS-DOS идентифицируются по идентификатору authenticationID. (AuthenticationID — это локальный уникальный идентификатор (LUID), связанный с сеансом входа в систему.) Это может повлиять на приложения, которые вызывают одну из функций WNet для создания буквы сетевого диска при входе одного пользователя, но запрашивают существующие буквы сетевых дисков при входе другого пользователя. Примером такой ситуации может быть создание второго входа пользователя в сеансе входа, например путем вызова функции CreateProcessAsUser , а при втором входе запускается приложение, которое вызывает функцию GetLogicalDrives . GetLogicalDrives не возвращает буквы сетевых дисков, созданные функцией WNet при первом входе в систему. Обратите внимание, что в предыдущем примере первый сеанс входа по-прежнему существует, и этот пример может применяться к любому сеансу входа, включая сеанс служб терминалов. Дополнительные сведения см. в разделе Определение имени устройства MS-DOS.

Требования

См. также раздел

WNetAddConnection2

WNetAddConnection3

WNetGetConnection

Общие сведения о сети Windows (WNet)

Сетевые функции Windows

WnetCancelConnection