ISecurityCallContext::IsSecurityEnabled method (comsvcs.h)

Article
02/22/2024

Determines whether security is enabled for the object.

Syntax

HRESULT IsSecurityEnabled(
  [out] VARIANT_BOOL *pfIsEnabled
);

Parameters

[out] pfIsEnabled

TRUE if the application uses role-based security and role checking is currently enabled for the object; otherwise, FALSE.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, and S_OK.

Remarks

COM+ applications can use one of two types of security: role-based security or process access permissions. If role-based security is being used by the application but is currently disabled, either at the application or component level, pfIsEnabled is FALSE. Similarly, if the COM+ application uses process access permissions instead of role-based security, pfIsEnabled is FALSE.

You can use this method to find out whether role-based security is enabled before you check role membership using IsCallerInRole. The reason for doing this is that IsCallerInRole is TRUE when role-based security is not enabled.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	comsvcs.h