Voltar à lista
Windows Win32Segurança & tokensadvapi32.dll

GetFileSecurityW

Consulta o security descriptor (dono, grupo, DACL, SACL) de um arquivo, por caminho.

Descrição

Análogo a `stat`/`getxattr(security.*)` combinados do Linux para inspecionar permissões e dono de um arquivo.

Header: winbase.hDLL: advapi32.dllNative API: NtQuerySecurityObject

Assinatura

BOOL GetFileSecurityW(
    LPCWSTR lpFileName,
    SECURITY_INFORMATION RequestedInformation,
    PSECURITY_DESCRIPTOR pSecurityDescriptor,
    DWORD nLength,
    LPDWORD lpnLengthNeeded
);

Parâmetros

ParâmetroTipoDescrição
lpFileNameLPCWSTRCaminho do arquivo.
RequestedInformationSECURITY_INFORMATIONOWNER_SECURITY_INFORMATION, DACL_SECURITY_INFORMATION, etc.
pSecurityDescriptorPSECURITY_DESCRIPTORRecebe o security descriptor.
nLengthDWORDTamanho do buffer `pSecurityDescriptor`.
lpnLengthNeededLPDWORDRecebe o tamanho real necessário.

Valor de retorno

Diferente de zero em sucesso; 0 em erro (consulte GetLastError).

Códigos de erro (GetLastError)

ERROR_ACCESS_DENIED(5)
Acesso negado.
ERROR_INSUFFICIENT_BUFFER(122)
O buffer de dados é pequeno demais.

Relacionadas

Mesma categoria

AdjustTokenPrivilegesCheckTokenMembershipDecryptFileWDuplicateTokenExEncryptFileWGetTokenInformationImpersonateLoggedOnUserInitializeSecurityDescriptor