SecurityIdentity class
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 |
|