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.

Value	Significado
OWNER_SECURITY_INFORMATION	El descriptor de seguridad debe incluir el SID del propietario del objeto.
GROUP_SECURITY_INFORMATION	El descriptor de seguridad debe incluir el SID del grupo principal del objeto.
DACL_SECURITY_INFORMATION	El descriptor de seguridad debe incluir la DACL del objeto.
SACL_SECURITY_INFORMATION	El descriptor de seguridad debe incluir la SACL del objeto.

[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

Editor de Access Control

Funciones del editor de Access Control

ISecurityInformation

ISecurityInformation::GetObjectInformation

LocalFree

SECURITY_INFORMATION