BuildExplicitAccessWithNameW 函数是 Windows API 中 Aclapi.h 头文件中的一个函数,用于构建 EXPLICIT_ACCESS_W 结构,其中包含一个明确指定的访问权限。这个函数在访问控制列表 (ACL) 条目的设置中常用。

下面是该函数的定义:
BOOL BuildExplicitAccessWithNameW(
  PEXPLICIT_ACCESSW pExplicitAccess,
  LPWSTR           pTrusteeName,
  DWORD            AccessPermissions,
  ACCESS_MODE      AccessMode,
  DWORD            Inheritance
);

参数说明如下:

  •  pExplicitAccess:一个指向 EXPLICIT_ACCESS_W 结构的指针,用于存储构建的访问权限信息。


  •  pTrusteeName:一个以 NULL 结尾的宽字符(Unicode)字符串,表示要授予或拒绝访问权限的受信任实体的名称。


  •  AccessPermissions:一个 DWORD 值,表示要授予或拒绝的访问权限。可以是多个权限的组合,例如 FILE_READ_DATA | FILE_WRITE_DATA。


  •  AccessMode:一个 ACCESS_MODE 枚举值,表示执行的操作,如授予(GRANT_ACCESS)或拒绝(DENY_ACCESS)。


  •  Inheritance:一个 DWORD 值,表示继承的方式。通常是 NO_INHERITANCE、SUB_CONTAINERS_AND_OBJECTS_INHERIT 等。


该函数用于构建一个 EXPLICIT_ACCESS_W 结构,以描述要添加到访问控制列表中的访问权限。EXPLICIT_ACCESS_W 结构可以传递给其他 API 函数,如 SetEntriesInAcl,用于设置 ACL 条目。

如果你的应用程序使用 ANSI 字符集,可以使用 BuildExplicitAccessWithNameA 函数,其中结尾的 "A" 表示 ANSI 字符集。


转载请注明出处:http://www.zyzy.cn/article/detail/23760/Win32 API/Aclapi.h/BuildExplicitAccessWithNameW