Edit

SecurityIdentity class

  • Article

Provides access to a collection of security information representing a caller's identity. Using this class, you can find out about a particular caller in a chain of callers that is part of the security call context. For more information about how security call context information is accessed, see Programmatic Component Security.

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

When to implement

This class is implemented by COM+.

Requirement Value
Interfaces ISecurityIdentityColl

When to use

Use this class to access the methods of ISecurityIdentityColl.

Remarks

You cannot directly create a SecurityIdentity object. To use the methods of ISecurityIdentityColl, 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"). Then call ISecurityIdentityColl::get_Item to retrieve a security identity item (such as "Name" or "AuthenticationService").

To use this class from Microsoft Visual Basic, add a reference to the COM+ Services Type Library. You cannot directly create a SecurityIdentity 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"). Then, use the Item property of the SecurityIdentity object to retrieve a security identity item (such as "Name" or "AuthenticationService").

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

SecurityCallers