Método ISecurityInformation::GetSecurity (aclui.h)
El método GetSecurity solicita un descriptor de seguridad para el objeto protegible cuyo descriptor de seguridad se está editando. El editor de control de acceso llama a este método para recuperar el descriptor de seguridad actual o predeterminado del objeto.
Sintaxis
HRESULT GetSecurity(
[in] SECURITY_INFORMATION RequestedInformation,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
[in] BOOL fDefault
);
Parámetros
[in] RequestedInformation
Conjunto de marcas de bits de SECURITY_INFORMATION que indican las partes del descriptor de seguridad que se solicita. Este parámetro puede ser una combinación de los valores siguientes.
[out] ppSecurityDescriptor
Puntero a una variable que la implementación debe establecer en un puntero al descriptor de seguridad del objeto. El descriptor de seguridad debe incluir los componentes solicitados por el parámetro RequestedInformation .
El sistema llama a la función LocalFree para liberar el puntero devuelto.
[in] fDefault
Si este parámetro es TRUE, ppSecurityDescriptor debe devolver un descriptor de seguridad predeterminado definido por la aplicación para el objeto. El editor de control de acceso usa este descriptor de seguridad predeterminado para reinicializar la página de propiedades.
El editor de control de acceso establece este parámetro en TRUE solo si el usuario hace clic en el botón Predeterminado . El botón Predeterminado solo se muestra si establece la marca SI_RESET en el método ISecurityInformation::GetObjectInformation . Si no hay ningún descriptor de seguridad predeterminado disponible, no establezca la marca SI_RESET.
Si esta marca es FALSE, ppSecurityDescriptor debe devolver el descriptor de seguridad actual del objeto.
Valor devuelto
Devuelve S_OK si se ejecuta correctamente.
Devuelve un código de error distinto de cero si se produce un error. Devuelve E_ACCESSDENIED si el usuario no tiene permiso para leer la información de seguridad solicitada.
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 |
Consulte también
Funciones del editor de Access Control