GetFileSecurityA, fonction (winbase.h)

Article
08/27/2023

La fonction GetFileSecurity obtient des informations spécifiées sur la sécurité d’un fichier ou d’un répertoire. Les informations obtenues sont limitées par les droits d’accès et les privilèges de l’appelant.

La fonction GetNamedSecurityInfo fournit des fonctionnalités similaires à GetFileSecurity pour les fichiers ainsi que d’autres types d’objets.

Syntaxe

BOOL GetFileSecurityA(
  [in]            LPCSTR               lpFileName,
  [in]            SECURITY_INFORMATION RequestedInformation,
  [out, optional] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]            DWORD                nLength,
  [out]           LPDWORD              lpnLengthNeeded
);

Paramètres

[in] lpFileName

Pointeur vers une chaîne terminée par null qui spécifie le fichier ou le répertoire pour lequel les informations de sécurité sont récupérées.

[in] RequestedInformation

Valeur SECURITY_INFORMATION qui identifie les informations de sécurité demandées.

[out, optional] pSecurityDescriptor

Pointeur vers une mémoire tampon qui reçoit une copie du descripteur de sécurité de l’objet spécifié par le paramètre lpFileName . Le processus appelant doit avoir l’autorisation d’afficher les aspects spécifiés de la status de sécurité de l’objet. La structure SECURITY_DESCRIPTOR est retournée au format de descripteur de sécurité auto-relatif .

[in] nLength

Spécifie la taille, en octets, de la mémoire tampon pointée vers le paramètre pSecurityDescriptor .

[out] lpnLengthNeeded

Pointeur vers la variable qui reçoit le nombre d’octets nécessaires pour stocker le descripteur de sécurité complet. Si le nombre d’octets retourné est inférieur ou égal à nLength, le descripteur de sécurité entier est retourné dans la mémoire tampon de sortie ; sinon, aucun descripteur n’est retourné.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Pour lire le propriétaire, le groupe ou la liste dacl à partir du descripteur de sécurité pour le fichier ou le répertoire spécifié, la liste DACL du fichier ou du répertoire doit accorder à READ_CONTROL l’accès à l’appelant, ou l’appelant doit être le propriétaire du fichier ou du répertoire.

Pour lire la liste SACL d’un fichier ou d’un répertoire, le privilège SE_SECURITY_NAME doit être activé pour le processus appelant.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll