AuthzRegisterCapChangeNotification function (authz.h)

The AuthzRegisterCapChangeNotification function registers a CAP update notification callback.

Syntax

AUTHZAPI BOOL AuthzRegisterCapChangeNotification(
  [out]          PAUTHZ_CAP_CHANGE_SUBSCRIPTION_HANDLE phCapChangeSubscription,
  [in]           LPTHREAD_START_ROUTINE                pfnCapChangeCallback,
  [in, optional] PVOID                                 pCallbackContext
);

Parameters

[out] phCapChangeSubscription

Pointer to the CAP change notification subscription handle. When you have finished using the handle, unsubscribe by passing this parameter to the AuthzUnregisterCapChangeNotification function.

[in] pfnCapChangeCallback

The CAP change notification callback function.

[in, optional] pCallbackContext

The context of the user to be passed to the callback function.

Return value

If the function succeeds, it returns TRUE.

If the function fails, it returns FALSE. To get extended error information, call GetLastError.

Remarks

This function is intended for applications that manually manage CAP usage to get notified of CAP changes in the system.

Requirements

See also

AuthzUnregisterCapChangeNotification

Central Access Policies

How AccessCheck Works