Функция 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, этот параметр имеет значение 0. Если функция завершается сбоем, маска не изменяется.
[out] pbAccessStatus
Указатель на переменную, которая получает результаты проверка доступа.
Если функция выполнена успешно и предоставлен запрошенный набор прав доступа, этому параметру присваивается значение TRUE. В противном случае этому параметру присваивается значение FALSE. Если функция завершается сбоем, состояние не изменяется.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет S_OK. В противном случае функция возвращает один из кодов com-ошибок, определенных в файле заголовка пакета SDK для платформы WinError.h.
Комментарии
Функция RSoPFileAccessCheck в параметре pbAccessStatus указывает, предоставлен или запрещен доступ клиенту, определенному с помощью RSOPTOKEN. Если доступ предоставлен, запрошенная маска доступа становится маской доступа, предоставленной объекту.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | userenv.h |
| Библиотека | Userenv.lib |
| DLL | Userenv.dll |