IEffectivePermission::GetEffectivePermission-Methode (aclui.h)

Artikel
02/26/2024

Die GetEffectivePermission-Methode gibt die effektive Berechtigung für einen Objekttyp zurück.

Syntax

HRESULT GetEffectivePermission(
  [in]  const GUID           *pguidObjectType,
  [in]  PSID                 pUserSid,
  [in]  LPCWSTR              pszServerName,
  [in]  PSECURITY_DESCRIPTOR pSD,
  [out] POBJECT_TYPE_LIST    *ppObjectTypeList,
  [out] ULONG                *pcObjectTypeListLength,
  [out] PACCESS_MASK         *ppGrantedAccessList,
  [out] ULONG                *pcGrantedAccessListLength
);

Parameter

[in] pguidObjectType

Eine GUID für den Objekttyp, dessen Berechtigung abgefragt wird.

[in] pUserSid

Ein Zeiger auf eine SID-Struktur , die den Sicherheitsprinzipal darstellt, dessen effektive Berechtigung bestimmt wird.

[in] pszServerName

Ein Zeiger auf eine mit NULL beendete breite Zeichenfolge, die den Servernamen darstellt.

[in] pSD

Ein Zeiger auf eine SECURITY_DESCRIPTOR-Struktur , die die Sicherheitsbeschreibung des Objekts darstellt. Die Sicherheitsbeschreibung wird verwendet, um die Zugriffsprüfung durchzuführen.

[out] ppObjectTypeList

Ein Zeiger auf einen Zeiger auf eine OBJECT_TYPE_LIST Struktur, die das Array von Objekttypen in der Objektstruktur für das Objekt darstellt. Wenn ein Objekt den Eigenschaftenzugriff nicht unterstützt, verwenden Sie die folgende Technik, um den Wert für die OBJECT_TYPE_LIST anzugeben.

#include <windows.h>

OBJECT_TYPE_LIST g_DefaultOTL[] = {
 {0, 0, (LPGUID)&GUID_NULL},
};

[out] pcObjectTypeListLength

Ein Zeiger auf eine ULONG , die die Anzahl der Objekttypen empfängt, auf die von ppObjectTypeList verwiesen wird.

[out] ppGrantedAccessList

Ein Zeiger auf einen Zeiger auf einen ACCESS_MASK , der das Array der gewährten Zugriffsmasken empfängt. Das Betriebssystem verwendet LocalFree , um den für diesen Parameter zugewiesenen Arbeitsspeicher freizugeben.

[out] pcGrantedAccessListLength

Ein Zeiger auf eine ULONG-Variable , die die Anzahl der gewährten Zugriffsmasken empfängt, auf die der ppGrantedAccessList-Parameter verweist.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein HRESULT , das den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

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

Freigeben über