rsopFileAccessCheck 函数 (userenv.h)

RSoPFileAccessCheck 函数确定文件的安全描述符是否向由 RSOPTOKEN 标识的客户端授予一组指定的文件访问权限。

语法

USERENVAPI HRESULT RsopFileAccessCheck(
  [in]  LPWSTR     pszFileName,
  [in]  PRSOPTOKEN pRsopToken,
  [in]  DWORD      dwDesiredAccessMask,
  [out] LPDWORD    pdwGrantedAccessMask,
  [out] LPBOOL     pbAccessStatus
);

参数

[in] pszFileName

指向相关文件名称的指针。 该文件必须已存在。

[in] pRsopToken

指向有效 RSOPTOKEN 的指针，表示尝试获取文件访问权限的客户端。

[in] dwDesiredAccessMask

指定一个访问掩码，该掩码指示检查的访问权限。 此掩码可以包含 通用、 标准和特定访问权限的组合。 有关详细信息，请参阅 访问权限和访问掩码。

[out] pdwGrantedAccessMask

指向接收已授予访问权限的访问掩码的指针。

如果函数成功， pbAccessStatus 参数将设置为 TRUE，并且掩码将更新为包含授予的标准权限和特定权限。 如果 pbAccessStatus 设置为 FALSE，则此参数设置为零。 如果该函数失败，则不会修改掩码。

[out] pbAccessStatus

指向接收访问检查结果的变量的指针。

如果函数成功，并且已授予请求的访问权限集，则此参数将设置为 TRUE。 否则，此参数设置为 FALSE。 如果函数失败，则不修改状态。

返回值

如果函数成功，则返回值 S_OK。 否则，该函数返回平台 SDK 头文件 WinError.h 中定义的 COM 错误代码之一。

注解

RSoPFileAccessCheck 函数在 pbAccessStatus 参数中指示是授予还是拒绝对 RSOPTOKEN 标识的客户端的访问权限。 如果授予访问权限，则请求的访问掩码将成为对象的已授权访问掩码。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	userenv.h
Library	Userenv.lib
DLL	Userenv.dll

另请参阅

组策略函数

组策略概述

RSoPAccessCheckByType