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 |
| 程式庫 | Userenv.lib |
| Dll | Userenv.dll |