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 |