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