Funzione RsopFileAccessCheck (userenv.h)
La funzione RSoPFileAccessCheck determina se il descrittore di sicurezza di un file concede un set specificato di diritti di accesso ai file al client identificato da un RSOPTOKEN.
Sintassi
USERENVAPI HRESULT RsopFileAccessCheck(
[in] LPWSTR pszFileName,
[in] PRSOPTOKEN pRsopToken,
[in] DWORD dwDesiredAccessMask,
[out] LPDWORD pdwGrantedAccessMask,
[out] LPBOOL pbAccessStatus
);
Parametri
[in] pszFileName
Puntatore al nome del file pertinente. Il file deve già esistere.
[in] pRsopToken
Puntatore a un RSOPTOKEN valido che rappresenta il client che tenta di ottenere l'accesso al file.
[in] dwDesiredAccessMask
Specifica una maschera di accesso che indica i diritti di accesso da controllare. Questa maschera può contenere una combinazione di diritti di accesso generici, standard e specifici. Per altre informazioni, vedere Diritti di accesso e maschere di accesso.
[out] pdwGrantedAccessMask
Puntatore a una maschera di accesso che riceve i diritti di accesso concessi.
Se la funzione ha esito positivo, il parametro pbAccessStatus è impostato su TRUE e la maschera viene aggiornata per contenere i diritti standard e specifici concessi. Se pbAccessStatus è impostato su FALSE, questo parametro è impostato su zero. Se la funzione ha esito negativo, la maschera non viene modificata.
[out] pbAccessStatus
Puntatore a una variabile che riceve i risultati del controllo di accesso.
Se la funzione ha esito positivo e viene concesso il set richiesto di diritti di accesso, questo parametro viene impostato su TRUE. In caso contrario, questo parametro è impostato su FALSE. Se la funzione ha esito negativo, lo stato non viene modificato.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è S_OK. In caso contrario, la funzione restituisce uno dei codici di errore COM definiti nel file di intestazione di Platform SDK WinError.h.
Commenti
La funzione RSoPFileAccessCheck indica, nel parametro pbAccessStatus , se l'accesso viene concesso o negato al client identificato da RSOPTOKEN. Se viene concesso l'accesso, la maschera di accesso richiesta diventa la maschera di accesso concessa all'oggetto.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | userenv.h |
| Libreria | Userenv.lib |
| DLL | Userenv.dll |