Skip to main content
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

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Authz.h

Library

Authz.lib

DLL

Authz.dll

See also

Central Access Policies
How AccessCheck Works
AuthzUnregisterCapChangeNotification