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. 그렇지 않으면 함수는 플랫폼 SDK 헤더 파일 WinError.h에 정의된 COM 오류 코드 중 하나를 반환합니다.
설명
RSoPFileAccessCheck 함수는 pbAccessStatus 매개 변수에서 RSOPTOKEN으로 식별된 클라이언트에 대한 액세스 권한이 부여되거나 거부되는지 여부를 나타냅니다. 액세스 권한이 부여되면 요청된 액세스 마스크가 개체에 부여된 액세스 마스크가 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | userenv.h |
| 라이브러리 | Userenv.lib |
| DLL | Userenv.dll |