通过

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
库 Ntoskrnl.lib

另请参阅

ACCESS_MASK

IoCreateFile