AuthzComputeGroupsCallback callback function
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 |