Función GetAclInformation (securitybaseapi.h)

Artículo
03/09/2024

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