Export (0) Print
Expand All

SHARE_INFO_1005 structure

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.

ValueMeaning
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).

ValueMeaning
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

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

Network Management Overview
Network Management Structures
Network Share Functions
NetShareGetInfo
NetShareSetInfo

 

 

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft