Структура 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