Método ISecurityInformation::GetAccessRights (aclui.h)

Artículo
02/28/2024

El método GetAccessRights solicita información sobre los derechos de acceso que se pueden controlar para un objeto protegible. El editor de control de acceso llama a este método para recuperar cadenas de visualización y otra información utilizada para inicializar las páginas de propiedades. Para obtener más información, consulte Derechos de acceso y Máscaras de acceso.

Sintaxis

HRESULT GetAccessRights(
  [in]  const GUID *pguidObjectType,
  [in]  DWORD      dwFlags,
  [out] PSI_ACCESS *ppAccess,
  [out] ULONG      *pcAccesses,
  [out] ULONG      *piDefaultAccess
);

Parámetros

[in] pguidObjectType

Puntero a una estructura GUID que identifica el tipo de objeto para el que se solicitan los derechos de acceso. Si este parámetro es NULL o un puntero a GUID_NULL, devuelva los derechos de acceso del objeto que se está editando. De lo contrario, el GUID identifica un tipo de objeto secundario devuelto por el método ISecurityInformation::GetInheritTypes . El GUID corresponde al miembro InheritedObjectType de una ACE específica del objeto.

[in] dwFlags

Conjunto de marcas de bits que indican la página de propiedades que se va a inicializar. Este valor es cero si se inicializa la página de seguridad básica. De lo contrario, es una combinación de los valores siguientes.

Valor	Significado
SI_ADVANCED	La hoja de propiedades advanced Security se está inicializando.
SI_EDIT_AUDITS	La hoja de propiedades Advanced Security incluye la página de propiedades Audit .
SI_EDIT_PROPERTIES	La hoja de propiedades de Advanced Security permite la edición de acees que se aplican a las propiedades y conjuntos de propiedades del objeto.

[out] ppAccess

Puntero a una matriz de estructuras de SI_ACCESS . La matriz debe incluir una entrada para cada derecho de acceso. Puede especificar derechos de acceso que se aplican al propio objeto, así como derechos de acceso específicos del objeto que se aplican solo a un conjunto de propiedades o a una propiedad en el objeto.

[out] pcAccesses

Puntero a ULONG que indica el número de entradas de la matriz ppAccess .

[out] piDefaultAccess

Puntero a ULONG que indica el índice de base cero de la entrada de matriz que contiene los derechos de acceso predeterminados. El editor de control de acceso usa esta entrada como derechos de acceso iniciales en una nueva ACE.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

Se llama al método GetAccessRights cada vez que se inicializa una página de propiedades.

El editor de control de acceso no libera el puntero devuelto en ppAccess.

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