SecurityCallers class

Provides access to information about individual callers in a collection of callers. The collection represents the chain of calls ending with the current call, and each caller in the collection represents the identity of one caller. Only callers who cross a boundary where security is checked are included in the chain of callers. (In the COM+ environment, security is checked at application boundaries.) Access to information about a particular caller's identity is provided through the SecurityIdentity class, an identity collection.

Only COM+ applications that use role-based security can access the SecurityCallers class. For more information on roles, see Role-Based Security Administration.

When to implement

This class is implemented by COM+.

Requirement Value
Interfaces ISecurityCallersColl

When to use

Use this class to access the methods of ISecurityCallersColl.

Remarks

You cannot directly create a SecurityCallers object. To use the methods of ISecurityCallersColl, you must obtain a reference to its implementation by calling CoGetCallContext, supplying IID_ISecurityCallContext for the riid parameter. Next, call ISecurityCallContext::get_Item requesting a security call context item that is a security identity collection (such as "DirectCaller" or "OriginalCaller").

To use this class from Microsoft Visual Basic, add a reference to the COM+ Services Type Library. You cannot directly create a SecurityCallers object. To use its properties, you must obtain a refernece to its implementation using GetSecurityCallContext. Next, get the Item property of the object, requesting a security call context item that is a security identity collection (such as "DirectCaller" or "OriginalCaller").

Requirements

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

See also

GetSecurityCallContext

ISecurityCallersColl

Programmatic Component Security

Role-Based Security Administration

SecurityCallContext

SecurityIdentity