IAccessControl::GrantAccessRights-Methode (iaccess.h)

  • Artikel

Führt die neue Liste der Zugriffsrechte mit den vorhandenen Zugriffsrechten für das Objekt zusammen.

Syntax

HRESULT GrantAccessRights(
  [in] PACTRL_ACCESSW pAccessList
);

Parameter

[in] pAccessList

Ein Zeiger auf die ACTRL_ACCESS-Struktur , die ein Array von Zugriffslisten für das Objekt enthält.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Durch das Zusammenführen der neuen Zugriffsliste mit den vorhandenen Zugriffsrechten wird sichergestellt, dass das Objekt mindestens über die angegebenen Zugriffsrechte verfügt. Dieser Mergeprozess besteht aus dem Hinzufügen der neuen verweigerten Zugriffsrechte vor den alten verweigerten Zugriffsrechten und den neuen zulässigen Zugriffsrechten vor den vorhandenen zulässigen Rechten. Keines der vorhandenen Rechte wird entfernt.

Nach einer Zusammenführung werden die Zugriffsrechte für ein Objekt wie folgt sortiert:

  1. [Neuer Zugriff verweigert]
  2. [Alter Zugriff verweigert]
  3. [Neuer Zugriff zulässig]
  4. [Alter Zugriff zulässig]
Die vom System bereitgestellte Implementierung von [ACTRL_ACCESS](.. Die Struktur /accctrl/ns-accctrl-explicit_access_a.md) wird auf 1 festgelegt. Darüber hinaus muss das lpProperty-Element der ACTRL_PROPERTY_ENTRYW-StrukturNULL sein, um anzugeben, dass die Zugriffseintragsliste für das Objekt selbst gilt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile iaccess.h

Weitere Informationen

IAccessControl