AuthzComputeGroupsCallback callback function

Article
01/07/2021

The AuthzComputeGroupsCallback function is an application-defined function that creates a list of security identifiers (SIDs) that apply to a client. AuthzComputeGroupsCallback is a placeholder for the application-defined function name.

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
);

Parameters

hAuthzClientContext [in]: A handle to a client context.
Args [in]: Data passed in the DynamicGroupArgs parameter of a call to the AuthzInitializeContextFromAuthzContext, AuthzInitializeContextFromSid, or AuthzInitializeContextFromToken function.
pSidAttrArray [out]: A pointer to a pointer variable that receives the address of an array of SID_AND_ATTRIBUTES structures. These structures represent the groups to which the client belongs.
pSidCount [out]: The number of structures in pSidAttrArray.
pRestrictedSidAttrArray [out]: A pointer to a pointer variable that receives the address of an array of SID_AND_ATTRIBUTES structures. These structures represent the groups from which the client is restricted.
pRestrictedSidCount [out]: The number of structures in pSidRestrictedAttrArray.

Return value

If the function successfully returns a list of SIDs, the return value is TRUE.

If the function fails, the return value is FALSE.

Remarks

Applications can also add SIDs to the client context by calling AuthzAddSidsToContext.

Attribute variables must be in the form of an expression when used with logical operators; otherwise, they are evaluated as unknown.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Redistributable	Windows Server 2003 Administration Tools Pack on Windows XP