IAccessControl::GetAllAccessRights-Methode (iaccess.h)
Ruft die gesamte Liste der Zugriffsrechte und/oder den Besitzer und die Gruppe für das angegebene Objekt ab.
Syntax
HRESULT GetAllAccessRights(
[in] LPWSTR lpProperty,
[out] PACTRL_ACCESSW_ALLOCATE_ALL_NODES *ppAccessList,
[out] PTRUSTEEW *ppOwner,
[out] PTRUSTEEW *ppGroup
);
Parameter
[in] lpProperty
Der Name der Eigenschaft. Wenn Sie die COM-Implementierung von IAccessControl verwenden, muss dieser Parameter NULL sein.
[out] ppAccessList
Die Adresse der Zeigervariable, die einen Zeiger auf die Zugriffslistenstruktur empfängt. Dieser Parameter kann nicht ACTRL_ACCESS werden.
Wenn der Aufruf erfolgreich ist, muss der Aufrufer den zugewiesenen Arbeitsspeicher mit der Funktion CoTaskMemFree freigeben. Beachten Sie, dass der Arbeitsspeicher zugeordnet ist(all_nodes), was bedeutet, dass alle Unterstrukturen in einem Block zugeordnet sind. Daher muss die gesamte Datenstruktur durch einen einzigen Aufruf von CoTaskMemFree freigegeben werden.
[out] ppOwner
Ein Zeiger auf eine TRUSTEE-Struktur , die die Besitzerinformationen empfängt. Wenn dieser Parameter nicht NULL ist und die Funktion erfolgreich ist, muss der Aufrufer den Arbeitsspeicher mit CoTaskMemFree freigeben.
[out] ppGroup
Ein Zeiger auf eine TRUSTEE-Struktur , die die Gruppeninformationen empfängt. Wenn dieser Parameter nicht NULL ist und die Funktion erfolgreich ist, muss der Aufrufer den Arbeitsspeicher mit CoTaskMemFree freigeben.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
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 |