Função RsopFileAccessCheck (userenv.h)
A função RSoPFileAccessCheck determina se o descritor de segurança de um arquivo concede um conjunto especificado de direitos de acesso de arquivo ao cliente identificado por um RSOPTOKEN.
Sintaxe
USERENVAPI HRESULT RsopFileAccessCheck(
[in] LPWSTR pszFileName,
[in] PRSOPTOKEN pRsopToken,
[in] DWORD dwDesiredAccessMask,
[out] LPDWORD pdwGrantedAccessMask,
[out] LPBOOL pbAccessStatus
);
Parâmetros
[in] pszFileName
Ponteiro para o nome do arquivo relevante. O arquivo já deve existir.
[in] pRsopToken
Ponteiro para um RSOPTOKEN válido que representa o cliente que está tentando obter acesso ao arquivo.
[in] dwDesiredAccessMask
Especifica uma máscara de acesso que indica os direitos de acesso a marcar. Essa máscara pode conter uma combinação de direitos de acesso genéricos, padrão e específicos. Para obter mais informações, consulte Direitos de Acesso e Máscaras de Acesso.
[out] pdwGrantedAccessMask
Ponteiro para uma máscara de acesso que recebe os direitos de acesso concedidos.
Se a função for bem-sucedida, o parâmetro pbAccessStatus será definido como TRUE e a máscara será atualizada para conter os direitos padrão e específicos concedidos. Se pbAccessStatus for definido como FALSE, esse parâmetro será definido como zero. Se a função falhar, a máscara não será modificada.
[out] pbAccessStatus
Ponteiro para uma variável que recebe os resultados da marcar de acesso.
Se a função for bem-sucedida e o conjunto solicitado de direitos de acesso for concedido, esse parâmetro será definido como TRUE. Caso contrário, esse parâmetro será definido como FALSE. Se a função falhar, o status não será modificado.
Retornar valor
Se a função for bem-sucedida, o valor retornado será S_OK. Caso contrário, a função retornará um dos códigos de erro COM definidos no arquivo de cabeçalho do SDK da Plataforma WinError.h.
Comentários
A função RSoPFileAccessCheck indica, no parâmetro pbAccessStatus , se o acesso é concedido ou negado ao cliente identificado pelo RSOPTOKEN. Se o acesso for concedido, a máscara de acesso solicitada se tornará a máscara de acesso concedida do objeto.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | userenv.h |
| Biblioteca | Userenv.lib |
| DLL | Userenv.dll |