ISecurityInformation::GetAccessRights-Methode (aclui.h)

Artikel
08/22/2023

Die GetAccessRights-Methode fordert Informationen zu den Zugriffsrechten an, die für ein sicherungsfähiges Objekt gesteuert werden können. Der Zugriffssteuerungs-Editor ruft diese Methode auf, um Anzeigezeichenfolgen und andere Informationen abzurufen, die zum Initialisieren der Eigenschaftenseiten verwendet werden. Weitere Informationen finden Sie unter Zugriffsrechte und Zugriffsmasken.

Syntax

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

Parameter

[in] pguidObjectType

Ein Zeiger auf eine GUID-Struktur , die den Typ des Objekts identifiziert, für das Zugriffsrechte angefordert werden. Wenn dieser Parameter NULL oder ein Zeiger auf GUID_NULL ist, geben Sie die Zugriffsrechte für das zu bearbeitende Objekt zurück. Andernfalls identifiziert die GUID einen untergeordneten Objekttyp, der von der ISecurityInformation::GetInheritTypes-Methode zurückgegeben wird. Die GUID entspricht dem InheritedObjectType-Member eines objektspezifischen ACE.

[in] dwFlags

Eine Reihe von Bitflags, die die Eigenschaftenseite angeben, die initialisiert wird. Dieser Wert ist 0, wenn die Grundlegende Sicherheitsseite initialisiert wird. Andernfalls handelt es sich um eine Kombination der folgenden Werte.

Wert	Bedeutung
SI_ADVANCED	Das Eigenschaftenblatt "Erweiterte Sicherheit " wird initialisiert.
SI_EDIT_AUDITS	Das Eigenschaftenblatt "Erweiterte Sicherheit " enthält die Eigenschaftenseite "Audit" .
SI_EDIT_PROPERTIES	Das Eigenschaftenblatt Advanced Security ermöglicht die Bearbeitung von ACEs, die für die Eigenschaften und Eigenschaftensätze des Objekts gelten.

[out] ppAccess

Ein Zeiger auf ein Array von SI_ACCESS Strukturen. Das Array muss einen Eintrag für jedes Zugriffsrecht enthalten. Sie können Zugriffsrechte angeben, die für das Objekt selbst gelten, sowie objektspezifische Zugriffsrechte, die nur für einen Eigenschaftssatz oder eine Eigenschaft für das Objekt gelten.

[out] pcAccesses

Ein Zeiger auf ULONG , der die Anzahl der Einträge im ppAccess-Array angibt.

[out] piDefaultAccess

Ein Zeiger auf ULONG , der den nullbasierten Index des Arrayeintrags angibt, der die Standardzugriffsrechte enthält. Der Zugriffssteuerungs-Editor verwendet diesen Eintrag als erste Zugriffsrechte in einem neuen ACE.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Die GetAccessRights-Methode wird jedes Mal aufgerufen, wenn eine Eigenschaftenseite initialisiert wird.

Der Zugriffssteuerungs-Editor gibt den in ppAccess zurückgegebenen Zeiger nicht frei.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	aclui.h