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

  • Статья

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

Синтаксис

typedef struct _USE_INFO_1 {
  LMSTR ui1_local;
  LMSTR ui1_remote;
  LMSTR ui1_password;
  DWORD ui1_status;
  DWORD ui1_asg_type;
  DWORD ui1_refcount;
  DWORD ui1_usecount;
} USE_INFO_1, *PUSE_INFO_1, *LPUSE_INFO_1;

Члены

ui1_local

Тип: LMSTR

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

Если определены _WIN32_WINNT или FORCE_UNICODE , это строка Юникода.

ui1_remote

Тип: LMSTR

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

\\servername\sharename

Если определены _WIN32_WINNT или FORCE_UNICODE , это строка Юникода.

ui1_password

Тип: LMSTR

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

Если определены _WIN32_WINNT или FORCE_UNICODE , это строка Юникода.

ui1_status

Тип: DWORD

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

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

ui1_asg_type

Тип: DWORD

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

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

ui1_refcount

Тип: DWORD

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

ui1_usecount

Тип: DWORD

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

Комментарии

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

Требования

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

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

NetUseAdd

NetUseEnum

NetUseGetInfo

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

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

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