Fonction RsopFileAccessCheck (userenv.h)
La fonction RSoPFileAccessCheck détermine si le descripteur de sécurité d’un fichier accorde un ensemble spécifié de droits d’accès aux fichiers au client identifié par un RSOPTOKEN.
Syntaxe
USERENVAPI HRESULT RsopFileAccessCheck(
[in] LPWSTR pszFileName,
[in] PRSOPTOKEN pRsopToken,
[in] DWORD dwDesiredAccessMask,
[out] LPDWORD pdwGrantedAccessMask,
[out] LPBOOL pbAccessStatus
);
Paramètres
[in] pszFileName
Pointeur vers le nom du fichier approprié. Le fichier doit déjà exister.
[in] pRsopToken
Pointeur vers un RSOPTOKEN valide représentant le client qui tente d’accéder au fichier.
[in] dwDesiredAccessMask
Spécifie un masque d’accès qui indique les droits d’accès à case activée. Ce masque peut contenir une combinaison de droits d’accès génériques, standard et spécifiques. Pour plus d’informations, consultez Droits d’accès et masques d’accès.
[out] pdwGrantedAccessMask
Pointeur vers un masque d’accès qui reçoit les droits d’accès accordés.
Si la fonction réussit, le paramètre pbAccessStatus a la valeur TRUE et le masque est mis à jour pour contenir les droits standard et spécifiques accordés. Si pbAccessStatus a la valeur FALSE, ce paramètre est défini sur zéro. Si la fonction échoue, le masque n’est pas modifié.
[out] pbAccessStatus
Pointeur vers une variable qui reçoit les résultats de l’case activée d’accès.
Si la fonction réussit et que l’ensemble de droits d’accès demandé est accordé, ce paramètre est défini sur TRUE. Sinon, ce paramètre a la valeur FALSE. Si la fonction échoue, le status n’est pas modifié.
Valeur retournée
Si la fonction réussit, la valeur de retour est S_OK. Sinon, la fonction retourne l’un des codes d’erreur COM définis dans le fichier d’en-tête du KIT de développement logiciel (SDK) de plateforme WinError.h.
Remarques
La fonction RSoPFileAccessCheck indique, dans le paramètre pbAccessStatus , si l’accès est accordé ou refusé au client identifié par le RSOPTOKEN. Si l’accès est accordé, le masque d’accès demandé devient le masque d’accès accordé à l’objet.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | userenv.h |
| Bibliothèque | Userenv.lib |
| DLL | Userenv.dll |