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

  • Статья

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

Синтаксис

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

Параметры

[in] lpNetResource

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

Значение Значение
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. В противном случае он должен вернуть код ошибки, который может быть одним из следующих.

Код возврата Описание
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 [только классические приложения]
Целевая платформа Windows
Header npapi.h