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

 

 

Show: