AuthzGetInformationFromContext-Funktion (authz.h)

Die AuthzGetInformationFromContext-Funktion gibt Informationen zu einem Authz-Kontext zurück.

Ab Windows Server 2012 und Windows 8 werden Gerätegruppen als TOKEN_GROUPS-Struktur zurückgegeben. Benutzer- und Geräteansprüche werden als AUTHZ_SECURITY_ATTRIBUTES_INFORMATION-Struktur zurückgegeben.

Syntax

AUTHZAPI BOOL AuthzGetInformationFromContext(
  [in]  AUTHZ_CLIENT_CONTEXT_HANDLE     hAuthzClientContext,
  [in]  AUTHZ_CONTEXT_INFORMATION_CLASS InfoClass,
  [in]  DWORD                           BufferSize,
  [out] PDWORD                          pSizeRequired,
  [out] PVOID                           Buffer
);

Parameter

[in] hAuthzClientContext

Ein Handle für den Kontext.

[in] InfoClass

Ein Wert der AUTHZ_CONTEXT_INFORMATION_CLASS-Enumeration , der den Typ der zurückzugebenden Informationen angibt.

[in] BufferSize

Größe des übergebenen Puffers.

[out] pSizeRequired

Ein Zeiger auf ein DWORD der Puffergröße, die zum Zurückgeben der Struktur erforderlich ist.

[out] Buffer

Ein Zeiger auf den Speicher, der die Informationen empfangen kann. Die zurückgegebene Struktur hängt von den im InfoClass-Parameter angeforderten Informationen ab.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird TRUE zurückgegeben.

Wenn die Funktion fehlschlägt, wird FALSE zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	authz.h
Bibliothek	Authz.lib
DLL	Authz.dll
Verteilbare Komponente	Windows Server 2003 Administration Tools Pack unter Windows XP

Weitere Informationen

AUTHZ_CONTEXT_INFORMATION_CLASS

AUTHZ_SECURITY_ATTRIBUTES_INFORMATION

Grundlegende Access Control-Funktionen

TOKEN_GROUPS