Freigeben über


IAccessControl::IsAccessAllowed-Methode (iaccess.h)

Bestimmt, ob der angegebene Treuhänder Über Zugriffsrechte für das Objekt oder die Eigenschaft verfügt.

Syntax

HRESULT IsAccessAllowed(
  [in]  PTRUSTEEW     pTrustee,
  [in]  LPWSTR        lpProperty,
  [in]  ACCESS_RIGHTS AccessRights,
  [out] BOOL          *pfAccessAllowed
);

Parameter

[in] pTrustee

Ein Zeiger auf eine TRUSTEE-Struktur .

[in] lpProperty

Der Name der Eigenschaft. Wenn Sie die COM-Implementierung von IAccessControl verwenden, muss dieser Parameter NULL sein.

[in] AccessRights

Die Zugriffsrechte für das Objekt. Wenn Sie die COM-Implementierung von IAccessControl verwenden, muss dieser Wert entweder 0 oder 1 (COM_RIGHTS_EXECUTE) sein.

[out] pfAccessAllowed

Gibt an, ob der Zugriff zulässig ist.

Rückgabewert

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

Hinweise

In der vom System bereitgestellten Implementierung von IAccessControl (CLSID_DCOMAccessControl) kann IsAccessAllowed nur während eines verteilten COM-Aufrufs aufgerufen werden, und der einzige gültige Treuhändername ist der Name des Clients.

In den folgenden Tabellen sind die objektspezifischen Zugriffsberechtigungen aufgeführt, die mit dem Verzeichnisdienst und der Speicherimplementierung von IAccessControl verwendet werden.

Die folgenden Berechtigungen sind spezifisch für DS-Objekte.

Zugriffsberechtigung BESCHREIBUNG
ACTRL_DS_OPEN Öffnen eines DS-Objekts
ACTRL_DS_CREATE_CHILD Erstellen eines untergeordneten Objekts
ACTRL_DS_DELETE_CHILD Löschen eines untergeordneten Objekts
ACTRL_DS_LIST Auflisten eines Objekts
ACTRL_DS_SELF Aktualisieren einer Mitgliederliste mit dem Treuhänder
ACTRL_DS_READ_PROP Lesen von Eigenschaften
ACTRL_DS_WRITE_PROP Schreibzugriffeigenschaften
 

Die folgenden Berechtigungen sind spezifisch für Dateiobjekte.

Zugriffsberechtigung BESCHREIBUNG
ACTRL_FILE_READ Lesen aus einer Datei
ACTRL_FILE_WRITE Schreiben in eine Datei
ACTRL_FILE_APPEND Anfügen an eine Datei
ACTRL_FILE_READ_PROP Lesen von Dateieigenschaften oder erweiterten Attributen
ACTRL_FILE_WRITE_PROP Schreiben von Dateieigenschaften oder erweiterten Attributen
ACTRL_FILE_EXECUTE Ausführen der Datei
ACTRL_FILE_READ_ATTRIB Lesen der Dateiattribute
ACTRL_FILE_WRITE_ATTRIB Schreiben der Dateiattribute
 

Die folgenden Berechtigungen sind spezifisch für Verzeichnisobjekte.

Zugriffsberechtigung BESCHREIBUNG
ACTRL_DIR_LIST Auflisten des Inhalts eines Verzeichnisses
ACTRL_DIR_CREATE_OBJECT Erstellen eines untergeordneten Objekts (Datei) in einem Verzeichnis
ACTRL_DIR_CREATE_CHILD Erstellen eines Unterverzeichnisses
ACTRL_DIR_DELETE_CHILD Löschen eines Unterverzeichnisses
ACTRL_DIR_TRAVERSE Durchqueren des Verzeichnisses
 

Die folgenden Berechtigungen sind spezifisch für Kernelobjekte.

Zugriffsberechtigung BESCHREIBUNG
ACTRL_KERNEL_TERMINATE Beenden eines Prozesses oder Threads
ACTRL_KERNEL_THREAD Erstellen eines Threads
ACTRL_KERNEL_VM Ausführen von Adressraumvorgängen
ACTRL_KERNEL_VM_READ Lesen aus dem Arbeitsspeicher
ACTRL_KERNEL_VM_WRITE Schreiben in den Arbeitsspeicher
ACTRL_KERNEL_DUP_HANDLE Duplizieren eines Handles
ACTRL_KERNEL_PROCESS Erstellen eines Prozesses
ACTRL_KERNEL_SET_INFO Abrufen von Kernelobjektinformationen oder -status
ACTRL_KERNEL_GET_INFO Festlegen von Kernelobjektinformationen oder -status
ACTRL_KERNEL_CONTROL Steuern eines Kernelobjekts (z. B. Anhalten eines Threads)
ACTRL_KERNEL_ALERT Warnen Sie ein Kernelobjekt.
ACTRL_KERNEL_GET_CONTEXT Abrufen des Threadkontexts
ACTRL_KERNEL_SET_CONTEXT Festlegen des Threadkontexts
ACTRL_KERNEL_TOKEN Festlegen des Threadtokens
ACTRL_KERNEL_IMPERSONATE Identität eines Clients annehmen
ACTRL_KERNEL_DIMPERSONATE Direkte Identitätswechsel eines Clients
 

Die folgenden Berechtigungen sind spezifisch für Druckerobjekte.

Zugriffsberechtigung BESCHREIBUNG
ACTRL_PRINT_SADMIN Verwalten eines Druckservers
ACTRL_PRINT_SLIST Auflisten eines Druckservers
ACTRL_PRINT_PADMIN Verwalten eines Druckers
ACTRL_PRINT_PUSE Verwenden eines Druckers
ACTRL_PRINT_JADMIN Verwalten eines Druckauftrags
 

Die folgenden Berechtigungen sind spezifisch für Dienstobjekte.

Zugriffsberechtigung BESCHREIBUNG
ACTRL_SVC_GET_INFO Starten eines Diensts
ACTRL_SVC_SET_INFO Beenden eines Diensts
ACTRL_SVC_STATUS Anhalten eines Diensts
ACTRL_SVC_LIST Auflisten der Dienste
ACTRL_SVC_START Starten eines Diensts
ACTRL_SVC_STOP Beenden eines Diensts
ACTRL_SVC_PAUSE Anhalten eines Diensts
ACTRL_SVC_INTERROGATE Abfragen des Diensts nach aktuellem status
ACTRL_SVC_UCONTROL Benutzerdefiniertes Steuerelement
 

Die folgenden Berechtigungen sind spezifisch für Registrierungsobjekte.

Zugriffsberechtigung BESCHREIBUNG
ACTRL_REG_QUERY Lesen eines Registrierungsunterschlüssels
ACTRL_REG_SET Schreiben eines Registrierungsunterschlüssels
ACTRL_REG_CREATE_CHILD Erstellen eines Registrierungsunterschlüssels
ACTRL_REG_LIST Auflisten eines Registrierungsunterschlüssels
ACTRL_REG_NOTIFY Erstellen einer Registrierungsbenachrichtigung
ACTRL_REG_LINK Erstellen einer symbolischen Verknüpfung
 

Die folgenden Berechtigungen sind spezifisch für Fensterobjekte.

Zugriffsberechtigung BESCHREIBUNG
ACTRL_WIN_CLIPBRD Aktivieren des Zugriffs auf die Zwischenablage
ACTRL_WIN_GLOBAL_ATOMS Aktivieren des globalen Atomzugriffs
ACTRL_WIN_CREATE Erstellen des Desktopzugriffs
ACTRL_WIN_LIST_DESK Auflisten der Desktops
ACTRL_WIN_LIST Auflisten der Fensterstation
ACTRL_WIN_READ_ATTRIBS Lesen der Attribute
ACTRL_WIN_WRITE_ATTRIBS Schreiben der Attribute
ACTRL_WIN_SCREEN Aktivieren des Zugriffs auf den Bildschirm
ACTRL_WIN_EXIT Aufrufen von ExitWindows oder ExitWindowsEx

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