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 |