Compartir a través de


Función GetAclInformation (securitybaseapi.h)

La función GetAclInformation recupera información sobre una lista de control de acceso (ACL).

Sintaxis

BOOL GetAclInformation(
  [in]  PACL                  pAcl,
  [out] LPVOID                pAclInformation,
  [in]  DWORD                 nAclInformationLength,
  [in]  ACL_INFORMATION_CLASS dwAclInformationClass
);

Parámetros

[in] pAcl

Puntero a una ACL. La función recupera información sobre esta ACL. Si se pasa un valor NULL, la función produce una infracción de acceso.

[out] pAclInformation

Puntero a un búfer para recibir la información solicitada. La estructura que se coloca en el búfer depende de la clase de información solicitada en el parámetro dwAclInformationClass .

[in] nAclInformationLength

Tamaño, en bytes, del búfer al que apunta el parámetro pAclInformation .

[in] dwAclInformationClass

Valor de la enumeración ACL_INFORMATION_CLASS que indica la clase de información solicitada. Este parámetro puede ser uno de los dos valores de esta enumeración:

  • Si el valor es AclRevisionInformation, la función rellena el búfer al que apunta el parámetro pAclInformation con una estructura ACL_REVISION_INFORMATION .
  • Si el valor es AclSizeInformation, la función rellena el búfer al que apunta el parámetro pAclInformation con una estructura ACL_SIZE_INFORMATION .

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero.

Si se produce un error en la función, devuelve cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado securitybaseapi.h (incluya Windows.h)
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

ACL_INFORMATION_CLASS

ACL_REVISION_INFORMATION

ACL_SIZE_INFORMATION

GetAce

InitializeAcl

IsValidAcl

Access Control de bajo nivel

Funciones de Access Control de bajo nivel

SetAclInformation