This topic has not yet been rated - Rate this topic

AuthzAccessCheckCallback callback function

Applies to: desktop apps only

The AuthzAccessCheckCallback function is an application-defined function that handles callback access control entries (ACEs) during an access check. AuthzAccessCheckCallback is a placeholder for the application-defined function name. The application registers this callback by calling AuthzInitializeResourceManager.

Syntax

BOOL CALLBACK AuthzAccessCheckCallback(
  __in      AUTHZ_CLIENT_CONTEXT_HANDLE hAuthzClientContext,
  __in      PACE_HEADER pAce,
  __in_opt  PVOID pArgs,
  __inout   PBOOL pbAceApplicable
);

Parameters

hAuthzClientContext [in]

A handle to a client context.

pAce [in]

A pointer to the ACE to evaluate for inclusion in the call to the AuthzAccessCheck function.

pArgs [in, optional]

Data passed in the DynamicGroupArgs parameter of the call to AuthzAccessCheck or AuthzCachedAccessCheck.

pbAceApplicable [in, out]

A pointer to a Boolean variable that receives the results of the evaluation of the logic defined by the application.

The results are TRUE if the logic determines that the ACE is applicable and will be included in the call to AuthzAccessCheck; otherwise, the results are FALSE.

Return value

If the function succeeds, the function returns TRUE.

If the function is unable to perform the evaluation, it returns FALSE. Use SetLastError to return an error to the access check function.

Remarks

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

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Redistributable

Windows Server 2003 Administration Tools Pack on Windows XP

See also

Basic Access Control Functions
AuthzAccessCheck
AuthzCachedAccessCheck
AuthzInitializeResourceManager

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ