Edit

SHARE_INFO_1005 structure (lmshare.h)

  • Article

Contains information about the shared resource.

Syntax

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

Members

shi1005_flags

A bitmask of flags that specify information about the shared resource.

Value Meaning
SHI1005_FLAGS_DFS
0x0001
 The specified share is present in a Dfs tree structure. This flag cannot be set with NetShareSetInfo.
SHI1005_FLAGS_DFS_ROOT
0x0002
 The specified share is the root volume in a Dfs tree structure. This flag cannot be set with NetShareSetInfo.
SHI1005_FLAGS_RESTRICT_EXCLUSIVE_OPENS
0x0100
 The specified share disallows exclusive file opens, where reads to an open file are disallowed.
SHI1005_FLAGS_FORCE_SHARED_DELETE
0x0200
 Shared files in the specified share can be forcibly deleted.
SHI1005_FLAGS_ALLOW_NAMESPACE_CACHING
0x0400
 Clients are allowed to cache the namespace of the specified share.
SHI1005_FLAGS_ACCESS_BASED_DIRECTORY_ENUM
0x0800
 The server will filter directory entries based on the access permissions that the user on the client computer has for the server on which the files reside. Only files for which the user has read access and directories for which the user has FILE_LIST_DIRECTORY access will be returned. If the user has SeBackupPrivilege, all available information will be returned.

For more information about file and directory access, see File Security and Access Rights.

For more information about SeBackupPrivilege, see Privilege Constants.

Note  This flag is supported only on servers running Windows Server 2003 with SP1 or later.
 
SHI1005_FLAGS_FORCE_LEVELII_OPLOCK
0x1000
 Prevents exclusive caching modes that can cause delays for highly shared read-only data.
Note  This flag is supported only on servers running Windows Server 2008 R2 or later.
 
SHI1005_FLAGS_ENABLE_HASH
0x2000
 Enables server-side functionality needed for peer caching support. Clients on high-latency or low-bandwidth connections can use alternate methods to retrieve data from peers if available, instead of sending requests to the server. This is only supported on shares configured for manual caching (CSC_CACHE_MANUAL_REINT).
Note  This flag is supported only on servers running Windows Server 2008 R2 or later.
 
SHI1005_FLAGS_ENABLE_CA
0X4000
 Enables Continuous Availability on a cluster share. Handles that are opened against a continuously available share can survive network failures as well as cluster node failures.
Note  This flag can only be set on a scoped share on a server that meets the following conditions:
  • It is running Windows Server 2012 or later.
  • It is in a cluster configuration.
  • It has the "Services for Continuously Available shares" role service installed.
 
Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008 and Windows Server 2003:  This flag is not supported.
 

The CSC_MASK and CSC_MASK_EXT mask values can be used to apply flags that are specific to client-side caching (CSC).

Value Meaning
CSC_MASK
0x0030
 Provides a mask for the following CSC states.
CSC_CACHE_MANUAL_REINT 0x0000
Automatic file-by-file reintegration is not allowed.
CSC_CACHE_AUTO_REINT 0x0010
File-by-file reintegration is allowed.
CSC_CACHE_VDO 0x0020
File opens do not need to be flowed.
CSC_CACHE_NONE 0x0030
CSC is disabled for this share.
CSC_MASK_EXT
0x2030
 Provides a mask for the following CSC states and options.
CSC_CACHE_MANUAL_REINT 0x0000
Automatic file-by-file reintegration is not allowed.
CSC_CACHE_AUTO_REINT 0x0010
File-by-file reintegration is allowed.
CSC_CACHE_VDO 0x0020
File opens do not need to be flowed.
CSC_CACHE_NONE 0x0030
CSC is disabled for this share.
SHI1005_FLAGS_ENABLE_HASH 0x2000
Enables server-side functionality needed for peer caching support.

Remarks

This structure can be retrieved by calling the NetShareGetInfo function. It can be set by calling the NetShareSetInfo function.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header lmshare.h (include Lm.h)

See also

NetShareGetInfo

NetShareSetInfo

Network Management Overview

Network Management Structures

Network Share Functions