Compartir a través de


Método IAccessControl::GrantAccessRights (iaccess.h)

Combina la nueva lista de derechos de acceso con los derechos de acceso existentes en el objeto .

Sintaxis

HRESULT GrantAccessRights(
  [in] PACTRL_ACCESSW pAccessList
);

Parámetros

[in] pAccessList

Puntero a la estructura ACTRL_ACCESS que contiene una matriz de listas de acceso para el objeto .

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Combinar la nueva lista de derechos de acceso con los derechos de acceso existentes garantiza que el objeto tenga al menos los derechos de acceso indicados. Este proceso de combinación consiste en agregar los nuevos derechos de acceso denegado antes de los antiguos derechos de acceso denegado y los nuevos derechos de acceso permitidos antes de los derechos permitidos existentes. Ninguno de los derechos existentes se quita.

Después de una combinación, los derechos de acceso de un objeto se ordenan de la siguiente manera:

  1. [Nuevo acceso denegado]
  2. [Acceso antiguo denegado]
  3. [Nuevo acceso permitido]
  4. [Acceso antiguo permitido]
Implementación proporcionada por el sistema de [ACTRL_ACCESS](.. La estructura /accctrl/ns-accctrl-explicit_access_a.md) se establece en 1. Además, el miembro lpProperty de la estructura ACTRL_PROPERTY_ENTRYW debe ser NULL para indicar que la lista de entradas de acceso se aplica al propio objeto.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado iaccess.h

Consulte también

IAccessControl