AuthzRegisterCapChangeNotification function

The AuthzRegisterCapChangeNotification function registers a CAP update notification callback.

Syntax

BOOL WINAPI AuthzRegisterCapChangeNotification(
  _Out_    PAUTHZ_CAP_CHANGE_SUBSCRIPTION_HANDLE phCapChangeSubscription,
  _In_     LPTHREAD_START_ROUTINE                pfnCapChangeCallback,
  _In_opt_ PVOID                                 pCallbackContext
);

Parameters

phCapChangeSubscription [out]

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

pfnCapChangeCallback [in]

The CAP change notification callback function.

pCallbackContext [in, optional]

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

Central Access Policies

How AccessCheck Works

AuthzUnregisterCapChangeNotification