AuthzComputeGroupsCallback-Rückruffunktion

  • Artikel

Die AuthzComputeGroupsCallback-Funktion ist eine anwendungsdefinierte Funktion, die eine Liste von Sicherheits-IDs (SIDs) erstellt, die für einen Client gelten. AuthzComputeGroupsCallback ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

BOOL CALLBACK AuthzComputeGroupsCallback(
  _In_  AUTHZ_CLIENT_CONTEXT_HANDLE hAuthzClientContext,
  _In_  PVOID                       Args,
  _Out_ PSID_AND_ATTRIBUTES         *pSidAttrArray,
  _Out_ PDWORD                      pSidCount,
  _Out_ PSID_AND_ATTRIBUTES         *pRestrictedSidAttrArray,
  _Out_ PDWORD                      pRestrictedSidCount
);

Parameter

hAuthzClientContext [in]

Ein Handle für einen Clientkontext.

Args [in]

Daten, die im DynamicGroupArgs-Parameter eines Aufrufs der Funktion AuthzInitializeContextFromAuthzContext, AuthzInitializeContextFromSid oder AuthzInitializeContextFromToken übergeben werden.

pSidAttrArray [out]

Ein Zeiger auf eine Zeigervariable, die die Adresse eines Arrays von SID_AND_ATTRIBUTES Strukturen empfängt. Diese Strukturen stellen die Gruppen dar, zu denen der Client gehört.

pSidCount [out]

Die Anzahl der Strukturen in pSidAttrArray.

pRestrictedSidAttrArray [out]

Ein Zeiger auf eine Zeigervariable, die die Adresse eines Arrays von SID_AND_ATTRIBUTES Strukturen empfängt. Diese Strukturen stellen die Gruppen dar, aus denen der Client eingeschränkt ist.

pRestrictedSidCount [out]

Die Anzahl der Strukturen in pSidRestrictedAttrArray.

Rückgabewert

Wenn die Funktion erfolgreich eine Liste von SIDs zurückgibt, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE.

Bemerkungen

Anwendungen können dem Clientkontext auch SIDs hinzufügen, indem sie AuthzAddSidsToContext aufrufen.

Attributvariablen müssen in Form eines Ausdrucks vorliegen, wenn sie mit logischen Operatoren verwendet werden. Andernfalls werden sie als unbekannt ausgewertet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2003 [nur Desktop-Apps]
Verteilbare Komponente
 Windows Server 2003 Administration Tools Pack unter Windows XP

Siehe auch

Grundlegende Access Control-Funktionen

AuthzAddSidsToContext

AuthzCachedAccessCheck

AuthzInitializeContextFromAuthzContext

AuthzInitializeContextFromSid

AuthzInitializeContextFromToken

AuthzInitializeResourceManager

SID_AND_ATTRIBUTES