Поделиться через

Функция NPAddConnection (npapi.h)

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

Синтаксис

DWORD NPAddConnection(
  [in] LPNETRESOURCEW lpNetResource,
  [in] LPWSTR         lpPassword,
  [in] LPWSTR         lpUserName
);

Параметры

[in] lpNetResource

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

Ценность Meaning
lpRemoteName
 Указывает сетевой ресурс для подключения.
lpLocalName
 Указывает имя перенаправленного локального устройства, например "F:" или "LPT1". Это имя считается нечувствительным к регистру и может быть пустой строкой или указателем NULL . Если строка пуста или null, функция подключается к сетевому ресурсу без перенаправления.
dwType
 Указывает тип ресурса для подключения. Это может быть RESOURCETYPE_DISK, RESOURCETYPE _PRINT или RESOURCETYPE_ANY. Значение RESOURCETYPE _ANY используется, если вызывающий объект не заботится или не знает.

[in] lpPassword

Указатель на пароль, используемый при подключении, обычно пароль, связанный с lpUserName. Значение NULL может быть передано, чтобы функция использовала пароль по умолчанию. Пустая строка может использоваться для указания пароля. Завершив использование пароля, очистите его от памяти, вызвав функцию SecureZeroMemory . Дополнительные сведения о защите пароля см. в разделе "Обработка паролей".

[in] lpUserName

Указатель на имя пользователя, используемое для подключения. Если значение NULL, применяется имя пользователя по умолчанию (имя пользователя, вошедшего в систему) по умолчанию. Это используется, когда пользователь хочет подключиться к ресурсу, но имеет другое назначенное имя пользователя или учетную запись для этого ресурса.

Например, если вы зарегистрировались с помощью имени пользователя MyAccount и хотели подключиться к сетевому ресурсу, который был доступен только второй учетной записи, где имя пользователя было "MyOtherAccount", можно указать "MyOtherAccount" в lpUserName , чтобы подключиться к ресурсу. Вы также укажите пароль этой второй учетной записи в lpPassword.

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

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

Код возврата Description
WN_BAD_NETNAME
 Значение элемента lpRemoteName структуры, переданного в lpNetResource , недопустимо для этого поставщика.
WN_BAD_LOCALNAME
 Недопустимое значение элемента lpLocalName структуры, переданного в lpNetResource .
WN_BAD_PASSWORD
 Указанный пароль недопустим.
WN_ALREADY_CONNECTED
 Устройство, указанное в элементе lpLocalName структуры, переданной в lpNetResource , уже подключено.
WN_ACCESS_DENIED
 Разрешение на установку подключения запрещено.
WN_NO_NETWORK
 Сеть отсутствует.

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
целевая платформа Виндоус
Header npapi.h
Library davclnt.lib
  • Last updated on