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

Структура NETRESOURCEA (winnetwk.h)

  • Статья

Следующая структура содержит сведения о сетевом ресурсе. Он используется несколькими функциями поставщика сети, включая NPOpenEnum и NPAddConnection.

Синтаксис

typedef struct _NETRESOURCEA {
  DWORD dwScope;
  DWORD dwType;
  DWORD dwDisplayType;
  DWORD dwUsage;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  LPSTR lpComment;
  LPSTR lpProvider;
} NETRESOURCEA, *LPNETRESOURCEA;

Члены

dwScope

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

Ценность Значение
RESOURCE_CONNECTED
 Текущие подключения к сетевым ресурсам.
RESOURCE_GLOBALNET
 Все сетевые ресурсы. Они могут быть подключены или не подключены.
RESOURCE_CONTEXT
 Сетевые ресурсы, связанные с текущим и стандартным контекстом сети пользователя. Смысл этого — это значение, зависяющее от поставщика.

dwType

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

Ценность Значение
RESOURCETYPE_DISK
 Ресурс — это общий том диска.
RESOURCETYPE_PRINT
 Ресурс является общим принтером.
RESOURCETYPE_ANY
 Ресурс соответствует нескольким типам, например контейнеру ресурсов печати и диска, или ресурсу, который не является печатью или диском.

dwDisplayType

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

Ценность Значение
RESOURCEDISPLAYTYPE_NETWORK
 Ресурс является поставщиком сети.
RESOURCEDISPLAYTYPE_DOMAIN
 Ресурс — это коллекция серверов.
RESOURCEDISPLAYTYPE_SERVER
 Ресурс является сервером.
RESOURCEDISPLAYTYPE_SHARE
 Ресурс является точкой общего доступа.
RESOURCEDISPLAYTYPE_DIRECTORY
 Ресурс является каталогом.
RESOURCEDISPLAYTYPE_GENERIC
 Тип ресурса не указан. Это значение используется поставщиками сети, которые не указывают типы ресурсов.

dwUsage

Битовая маска, указывающая, как можно перечислить сведения о ресурсе. Он определяется только в том случае, если dwScope имеет значение RESOURCE_GLOBALNET. Поле dwUsage может содержать один или несколько следующих флагов.

Ценность Значение
RESOURCEUSAGE_CONNECTABLE
 Вы можете подключиться к ресурсу, вызвав NPAddConnection. Если dwType RESOURCETYPE_DISK, то после подключения к ресурсу можно использовать API файловой системы, такие как FindFirstFileи FindNextFile, чтобы перечислить все файлы и каталоги, содержащиеся в ресурсе.
RESOURCEUSAGE_CONTAINER
 Ресурс — это контейнер для других ресурсов, которые можно перечислить с помощью NPOpenEnum, NPEnumResourceи функции NPCloseEnum.

Однако контейнер может быть пустым во время перечисления. Другими словами, первый вызов NPEnumResource может возвращать WN_NO_MORE_ENTRIES.

lpLocalName

Если dwScope RESOURCE_CONNECTED, поле lpLocalName содержит имя перенаправленного устройства. Если подключение является бессерверным подключением, это поле содержит NULL.

Если dwScope не задано RESOURCE_CONNECTED, это поле не определено.

lpRemoteName

Если перечисленный элемент является сетевым ресурсом, это поле содержит имя удаленной сети. Это имя может быть передано NPAddConnection, чтобы сделать сетевое подключение, если dwUsage задано значение RESOURCEUSAGE_CONNECTABLE. Если перечислимый элемент является текущим подключением, это поле будет ссылаться на имя удаленной сети, к которому подключено lpLocalName.

lpComment

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

lpProvider

Указывает имя поставщика, которому принадлежит указанный элемент.

Замечания

Заметка

Заголовок winnetwk.h определяет NETRESOURCE как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
заголовка winnetwk.h