IoSetShareAccessEx 函数 (wdm.h)

IoSetShareAccessEx 例程设置共享指定文件对象的访问权限。

语法

void IoSetShareAccessEx(
  [in]           ACCESS_MASK   DesiredAccess,
  [in]           ULONG         DesiredShareAccess,
  [in, out]      PFILE_OBJECT  FileObject,
  [out]          PSHARE_ACCESS ShareAccess,
  [in, optional] PBOOLEAN      WritePermission
);

参数

[in] DesiredAccess

指定一个 ACCESS_MASK 值，该值表示为文件对象请求的访问类型。 有关系统定义的 DesiredAccess 标志的完整列表，请参阅 IoCreateFile。

[in] DesiredShareAccess

指定要为文件对象设置的共享访问的类型。 此值可以是零，也可以是以下标志的任意组合：

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

指向正在设置或重置共享访问权限的文件对象的指针。

[out] ShareAccess

指向与 FileObject 关联的SHARE_ACCESS结构的指针。 驱动程序应将此结构视为不透明结构。

[in, optional] WritePermission

指向值的指针，该值指定文件对象是否具有写入权限。 如果共享具有写入权限，则此值为 TRUE ;否则为 FALSE。 如果值为 FALSE ，并且调用方尝试采用独占读取访问权限，则写入权限将降级为FILE_SHARE_READ。

返回值

无

要求

要求	值
最低受支持的客户端	在 Windows 7 和更高版本的 Windows 中可用。
目标平台	通用
标头	wdm.h
Library	Ntoskrnl.lib

另请参阅

ACCESS_MASK

IoCreateFile