NAME¶

GetFileSecurityA (ADVAPI32.@)

SYNOPSIS¶

BOOL GetFileSecurityA
(
LPCSTR lpFileName,
SECURITY_INFORMATION RequestedInformation,
PSECURITY_DESCRIPTOR pSecurityDescriptor,
DWORD nLength,
LPDWORD lpnLengthNeeded
)

DESCRIPTION¶

Obtains Specified information about the security of a file or directory.

PARAMS¶

lpFileName [In] Name of the file to get information for. RequestedInformation [In] SE_ flags from "winnt.h". pSecurityDescriptor [Out] Destination for security information. nLength [In] Length of pSecurityDescriptor. lpnLengthNeeded [Out] Destination for length of returned security information.

RETURNS¶

Success: TRUE. pSecurityDescriptor contains the requested information. Failure: FALSE. lpnLengthNeeded contains the required space to return the info.

NOTES¶

The information returned is constrained by the callers access rights and privileges.

IMPLEMENTATION¶

Declared in "winbase.h". Implemented in "dlls/advapi32/security.c". Debug channel "advapi".