Función EditSecurity (aclui.h)

Artículo
02/23/2024

La función EditSecurity muestra una hoja de propiedades que contiene una página de propiedades de seguridad básica. Esta página de propiedades permite al usuario ver y editar los derechos de acceso permitidos o denegados por los ACA en la DACL de un objeto.

Sintaxis

BOOL ACLUIAPI EditSecurity(
  [in] HWND           hwndOwner,
  [in] LPSECURITYINFO psi
);

Parámetros

[in] hwndOwner

Identificador de la ventana que posee la hoja de propiedades. Este parámetro puede ser NULL.

[in] psi

Puntero a la implementación de la interfaz ISecurityInformation . El sistema llama a los métodos de interfaz para recuperar información sobre el objeto que se está editando y para devolver la entrada del usuario.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función EditSecurity llama a la función CreateSecurityPage para crear una página de propiedades de seguridad básica.

Durante la inicialización de la página de propiedades, el sistema llama a los métodos ISecurityInformation::GetSecurity e ISecurityInformation::SetSecurity para determinar si el usuario tiene permiso para editar el descriptor de seguridad del objeto. El sistema muestra un mensaje de error si el usuario no tiene permiso.

La página de propiedades de seguridad básica puede incluir un botón Avanzado para mostrar la hoja de propiedades de seguridad avanzada. Esta hoja de propiedades de seguridad avanzada puede contener tres páginas de propiedades adicionales que permiten al usuario ver y editar la DACL, SACL y el propietario del objeto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	aclui.h
Library	Aclui.lib
Archivo DLL	Aclui.dll