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

структура SHARE_INFO_1005 (lmshare.h)

  • Статья

Содержит сведения об общем ресурсе.

Синтаксис

typedef struct _SHARE_INFO_1005 {
  DWORD shi1005_flags;
} SHARE_INFO_1005, *PSHARE_INFO_1005, *LPSHARE_INFO_1005;

Члены

shi1005_flags

Битовая маска флагов, указывающих сведения о общем ресурсе.

Значение Значение
SHI1005_FLAGS_DFS
0x0001
 Указанная общая папка присутствует в древовидной структуре Dfs. Этот флаг нельзя задать с помощью NetShareSetInfo.
SHI1005_FLAGS_DFS_ROOT
0x0002
 Указанная общая папка является корневым томом в древовидной структуре Dfs. Этот флаг нельзя задать с помощью NetShareSetInfo.
SHI1005_FLAGS_RESTRICT_EXCLUSIVE_OPENS
0x0100
 Указанная общая папка запрещает открывать монопольный файл, где запрещено чтение в открытый файл.
SHI1005_FLAGS_FORCE_SHARED_DELETE
0x0200
 Общие файлы в указанной общей папке можно принудительно удалить.
SHI1005_FLAGS_ALLOW_NAMESPACE_CACHING
0x0400
 Клиентам разрешено кэшировать пространство имен указанной общей папки.
SHI1005_FLAGS_ACCESS_BASED_DIRECTORY_ENUM
0x0800
 Сервер будет фильтровать записи каталога на основе разрешений доступа, которые пользователь на клиентском компьютере имеет для сервера, на котором находятся файлы. Будут возвращены только файлы, для которых у пользователя есть доступ на чтение, и каталоги, для которых у пользователя есть FILE_LIST_DIRECTORY доступ. Если у пользователя есть SeBackupPrivilege, будут возвращены все доступные сведения.

Дополнительные сведения о доступе к файлам и каталогам см. в разделе Безопасность файлов и права доступа.

Дополнительные сведения о SeBackupPrivilege см. в разделе Константы привилегий.

Примечание Этот флаг поддерживается только на серверах под управлением Windows Server 2003 с пакетом обновления 1 (SP1) или более поздней версии.
 
SHI1005_FLAGS_FORCE_LEVELII_OPLOCK
0x1000
 Предотвращает монопольные режимы кэширования, которые могут привести к задержкам для общих данных только для чтения.
Примечание Этот флаг поддерживается только на серверах под управлением Windows Server 2008 R2 или более поздней версии.
 
SHI1005_FLAGS_ENABLE_HASH
0x2000
 Включает функциональные возможности на стороне сервера, необходимые для поддержки однорангового кэширования. Клиенты с подключениями с высокой задержкой или низкой пропускной способностью могут использовать альтернативные методы для получения данных от одноранговых узлов, если они доступны, вместо отправки запросов на сервер. Это поддерживается только в общих папках, настроенных для кэширования вручную (CSC_CACHE_MANUAL_REINT).
Примечание Этот флаг поддерживается только на серверах под управлением Windows Server 2008 R2 или более поздней версии.
 
SHI1005_FLAGS_ENABLE_CA
0X4000
 Включает непрерывную доступность в общей папке кластера. Дескрипторы, открытые для постоянно доступной общей папки, могут пережить сбои сети, а также сбои узлов кластера.
Примечание Этот флаг можно установить только для общей папки с заданной областью на сервере, который соответствует следующим условиям:
  • Он выполняется Windows Server 2012 или более поздней версии.
  • Он находится в конфигурации кластера.
  • На ней установлена служба роли "Службы для постоянно доступных общих папок".
 
Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008 и Windows Server 2003: Этот флаг не поддерживается.
 

Значения маски CSC_MASK и CSC_MASK_EXT можно использовать для применения флагов, характерных для кэширования на стороне клиента (CSC).

Значение Значение
CSC_MASK
0x0030
 Предоставляет маску для следующих состояний CSC.
CSC_CACHE_MANUAL_REINT 0x0000
Автоматическое восстановление по файлам не допускается.
0x0010 CSC_CACHE_AUTO_REINT
Допускается файловая реабилитация.
CSC_CACHE_VDO 0x0020
Открыть файл не нужно.
0x0030 CSC_CACHE_NONE
CSC отключен для этой общей папки.
CSC_MASK_EXT
0x2030
 Предоставляет маску для следующих состояний и параметров CSC.
CSC_CACHE_MANUAL_REINT 0x0000
Автоматическое восстановление по файлам не допускается.
0x0010 CSC_CACHE_AUTO_REINT
Допускается файловая реабилитация.
CSC_CACHE_VDO 0x0020
Открыть файл не нужно.
0x0030 CSC_CACHE_NONE
CSC отключен для этой общей папки.
0x2000 SHI1005_FLAGS_ENABLE_HASH
Включает функциональные возможности на стороне сервера, необходимые для поддержки однорангового кэширования.

Комментарии

Эту структуру можно получить, вызвав функцию NetShareGetInfo . Его можно задать, вызвав функцию NetShareSetInfo .

Требования

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

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

NetShareGetInfo

NetShareSetInfo

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

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

Функции общего сетевого ресурса