IAccessControl::GetAllAccessRights-Methode (iaccess.h)

  • Artikel

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

Weitere Informationen

ACTRL_ACCESS

IAccessControl