AccessCheck |
advapi32.dll | Vérification d'accès |
|---|---|---|
| Windows 9X, NT 3.1+, 2000, XP, 2003 | ||
Syntaxe
|
BOOL AccessCheck( PSECURITY_DESCRIPTOR pSecurityDescriptor, HANDLE ClientToken, DWORD DesiredAccess, PGENERIC_MAPPING GenericMapping, PPRIVILEGE_SET PrivilegeSet, LPDWORD PrivilegeSetLength, LPDWORD GrantedAccess, LPBOOL AccessStatus ); |
Paramètres
| Nom | Description |
|---|---|
| pSecurityDescriptor | Ce paramètre permet d'indiquer le descripteur d'adresse de sécurité. |
| ClientToken | Ce paramètre permet d'indiquer l'identificateur client. |
| DesiredAccess | Ce paramètre permet d'indiquer le masque d'accès. |
| GenericMapping | Ce paramètre permet d'indiquer l'adresse de la carte générique. |
| PrivilegeSet | Ce paramètre permet d'indiquer l'adresse de la structure de l'ensemble de privilège. |
| PrivilegeSetLength | Ce paramètre permet d'indiquer la taille de la structure de l'ensemble de privilège. |
| GrantedAccess | Ce paramètre permet d'indiquer le masque d'accès garantie. |
| AccessStatus | Ce paramètre permet d'indiquer l'adresse des drapeaux de masque d'accès garantie. |
Description
Cette fonction permet, à une application serveur, de vérifier les accès client à un objet de contrôle d'accès.
Remarques
- La fonction AccessCheck compare le descripteur de sécurité spécifié avec le jeton d'accès spécifié et indique, dans le paramètre AccessStatus, si l'accès est accordé ou refusé. Si l'accès est accordé, le masque d'accès demandé devient le masque d'accès accordé à l'objet.
- Si la liste DACL du descripteur de sécurité est NULL, le paramètre AccessStatus renvoie la valeur TRUE, ce qui indique que le client dispose de l'accès demandé.
- La fonction AccessCheck échoue avec ERROR_INVALID_SECURITY_DESCR si le descripteur de sécurité ne contient pas de SID de propriétaire et de groupe.
- La fonction AccessCheck ne génère pas de journal de bord. Si votre application nécessite un journal de bord pour les contrôles d'accès, utilisez des fonctions telles que AccessCheckAndAuditAlarm, AccessCheckByTypeAndAuditAlarm, AccessCheckByTypeResultListAndAuditAlarm ou AccessCheckByTypeRndultudistAndAuditAlarmByHandle, au lieu de AccessCheck.
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Samedi, le 5 décembre 2015