.\" -*- nroff -*-
.\" Generated file - DO NOT EDIT!
.TH GetFileSecurityA 3w "Oct 2012" "Wine API" "Wine API"

.SH NAME
\fBGetFileSecurityA\fR (ADVAPI32.@)
.SH SYNOPSIS
BOOL GetFileSecurityA
 (
  LPCSTR               \fIlpFileName\fR,
  SECURITY_INFORMATION \fIRequestedInformation\fR,
  PSECURITY_DESCRIPTOR \fIpSecurityDescriptor\fR,
  DWORD                \fInLength\fR,
  LPDWORD              \fIlpnLengthNeeded\fR
 )

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

.SH PARAMS
\fIlpFileName\fR \fB[In]\fR  Name of the file to get information for.
.PP
\fIRequestedInformation\fR \fB[In]\fR  \fBSE_\fR flags from \fB"winnt.h"\fR.
.PP
\fIpSecurityDescriptor\fR \fB[Out]\fR  Destination for security information.
.PP
\fInLength\fR \fB[In]\fR  Length of \fIpSecurityDescriptor\fR.
.PP
\fIlpnLengthNeeded\fR \fB[Out]\fR  Destination for length of returned security information.
.PP

.SH RETURNS
.PP
\fBSuccess:\fR \fBTRUE\fR. \fIpSecurityDescriptor\fR contains the requested information. 
.PP
\fBFailure:\fR \fBFALSE\fR. \fIlpnLengthNeeded\fR contains the required space to return the info. 

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

.SH IMPLEMENTATION
.PP
Declared in \fB"winbase.h"\fR. 
.PP
Implemented in \fB"dlls/advapi32/security.c"\fR. 
.PP
Debug channel \fB"advapi"\fR.