AUTHZ_INIT_INFO structure (authz.h)

The AUTHZ_INIT_INFO structure defines the initialization information for the resource manager.

Syntax

typedef struct _AUTHZ_INIT_INFO {
  USHORT                               version;
  PCWSTR                               szResourceManagerName;
  PFN_AUTHZ_DYNAMIC_ACCESS_CHECK       pfnDynamicAccessCheck;
  PFN_AUTHZ_COMPUTE_DYNAMIC_GROUPS     pfnComputeDynamicGroups;
  PFN_AUTHZ_FREE_DYNAMIC_GROUPS        pfnFreeDynamicGroups;
  PFN_AUTHZ_GET_CENTRAL_ACCESS_POLICY  pfnGetCentralAccessPolicy;
  PFN_AUTHZ_FREE_CENTRAL_ACCESS_POLICY pfnFreeCentralAccessPolicy;
} AUTHZ_INIT_INFO, *PAUTHZ_INIT_INFO;

Members

version

The version of the authorization resource manager initialization information structure. This must be set to AUTHZ_INIT_INFO_VERSION_V1 (1).

szResourceManagerName

Pointer to a Unicode string that identifies the resource manager. This parameter can be NULL if the resource manager does not need a name.

pfnDynamicAccessCheck

Pointer to an AuthzAccessCheckCallback callback function that the resource manager calls each time it encounters a callback access control entry (ACE) during access control list (ACL) evaluation in AuthzAccessCheck or AuthzCachedAccessCheck. This parameter can be NULL if no access check callback function is used.

pfnComputeDynamicGroups

Pointer to the AuthzComputeGroupsCallback callback function called by the resource manager during initialization of an AuthzClientContext handle. This parameter can be NULL if no callback function is used to compute dynamic groups.

pfnFreeDynamicGroups

Pointer to the AuthzFreeGroupsCallback callback function called by the resource manager to free security identifier (SID) attribute arrays allocated by the compute dynamic groups callback. This parameter can be NULL if no callback function is used to compute dynamic groups.

pfnGetCentralAccessPolicy

Pointer to the AuthzGetCentralAccessPolicyCallback callback function to be called by the resource manager to resolve any Central Access Policy ID ACE (SYSTEM_SCOPED_POLICY_ID_ACE) encountered by AuthzAccessCheck or AuthzCachedAccessCheck. If this parameter is NULL, the AuthzAccessCheck function will fall back to LSA to resolve the Central Access Policy ID ACE.

pfnFreeCentralAccessPolicy

Pointer to the AuthzFreeCentralAccessPolicyCallback callback function called by the resource manager to free the Central Access Policy allocated by the callback to get a central access policy. This parameter can be NULL if no callback function is specified for pfnGetCentralAccessPolicy

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Header authz.h