IGetSecurityCallContext::GetSecurityCallContext method (comsvcs.h)

Retrieves a reference to an object created from the SecurityCallContext class that is associated with the current call.

Instead of using this method, C++ developers should use the CoGetCallContext function, supplying IID_ISecurityCallContext for the riid parameter.

Syntax

HRESULT GetSecurityCallContext(
  [out] ISecurityCallContext **ppObject
);

Parameters

[out] ppObject

A reference to ISecurityCallContext on the object's context.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following values.

Return code Description
S_OK
The method completed successfully.
CONTEXT_E_NOCONTEXT
The current object does not have a context associated with it because either the component wasn't imported into an application or the object was not created with one of the COM+ CreateInstance methods. This error is also returned if the GetObjectContext method was called from a constructor or from an IUnknown method.

Remarks

With an object's security call context, you can retrieve items in the security call context collection, such as the minimum authentication level, the direct caller, the original caller, the chain of callers, and the number of callers. You can also call the IsSecurityEnabled and IsCallerInRole methods to ensure that a particular section of code is executed. However, you can call these methods only if role-based security is enabled and if the direct caller is a member of a specified role.

Requirements

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

See also

COM+ Contexts and Threading Models

CoGetCallContext

IGetSecurityCallContext

ISecurityCallContext