структура USE_INFO_2 (lmuse.h)

  • Статья

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

Синтаксис

typedef struct _USE_INFO_2 {
  LMSTR ui2_local;
  LMSTR ui2_remote;
  LMSTR ui2_password;
  DWORD ui2_status;
  DWORD ui2_asg_type;
  DWORD ui2_refcount;
  DWORD ui2_usecount;
  LMSTR ui2_username;
  LMSTR ui2_domainname;
} USE_INFO_2, *PUSE_INFO_2, *LPUSE_INFO_2;

Члены

ui2_local

Тип: LMSTR

Указатель на строку, содержащую имя локального устройства (например, диск E или LPT1), перенаправленное на общий ресурс. Константой DEVLEN определяется максимальное количество символов в строке. Этот элемент может иметь значение NULL. Дополнительные сведения см. в разделе "Примечания".

Эта строка является Юникодом, если определены _WIN32_WINNT или FORCE_UNICODE .

ui2_remote

Тип: LMSTR

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

\\servername\sharename

Эта строка является Юникодом, если определены _WIN32_WINNT или FORCE_UNICODE .

ui2_password

Тип: LMSTR

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

Эта строка является Юникодом, если определены _WIN32_WINNT или FORCE_UNICODE .

ui2_status

Тип: DWORD

Состояние подключения. Этот элемент не используется функцией NetUseAdd . Определены следующие значения.

Значение Значение
USE_OK
 Подключение выполнено успешно.
USE_PAUSED
 Приостановлено локальной рабочей станцией.
USE_SESSLOST
 отключен.
USE_DISCONN
 Произошла ошибка.
USE_NETERR
 Произошла сетевая ошибка.
USE_CONN
 Соединение выполняется.
USE_RECONN
 Повторное соединение.

ui2_asg_type

Тип: DWORD

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

Значение Значение
USE_WILDCARD
 Соответствует типу общих ресурсов сервера. Подстановочные знаки можно использовать только с функцией NetUseAdd и только в том случае, если элемент ui2_local является строкой NULL . Дополнительные сведения см. в разделе "Примечания".
USE_DISKDEV
 Дисковое устройство.
USE_SPOOLDEV
 Принтер с распущенной печатью.
USE_IPC
 Межпроцессная связь (IPC).

ui2_refcount

Тип: DWORD

Количество файлов, каталогов и других процессов, открытых в удаленном ресурсе. Этот элемент не используется функцией NetUseAdd .

ui2_usecount

Тип: DWORD

Количество явных подключений (перенаправление с именем локального устройства) или неявных UNC-подключений (перенаправление без имени локального устройства), установленных с ресурсом.

ui2_username

Тип: LPWSTR

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

Эта строка является Юникодом, если определены _WIN32_WINNT или FORCE_UNICODE .

ui2_domainname

Тип: LMSTR

Указатель на строку, содержащую доменное имя удаленного ресурса.

Эта строка является Юникодом, если определены _WIN32_WINNT или FORCE_UNICODE .

Комментарии

Указание элемента ui2_local , который имеет значение NULL , запрашивает проверку подлинности на сервере без перенаправления буквы диска или устройства. Будущие перенаправления с участием сервера при том же подключении используют сведения о проверке подлинности, указанные в первоначальном вызове функции NetUseAdd . Эти сведения включают сочетание элементов ui2_password, ui2_username и ui2_domainname .

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть lmuse.h (включая Lm.h)

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

NetUseAdd

NetUseEnum

NetUseGetInfo

Общие сведения об управлении сетью

Структуры управления сетью

Использование функций