CoGetCallContext function

Retrieves the context of the current call on the current thread.

Syntax

HRESULT CoGetCallContext(
  REFIID riid,
  void   **ppInterface
);

Parameters

riid

Interface identifier (IID) of the call context that is being requested. If you are using the default call context supported by standard marshaling, IID_IServerSecurity is available. For COM+ applications using role-based security, IID_ISecurityCallContext is available.

ppInterface

Address of pointer variable that receives the interface pointer requested in riid. Upon successful return, *ppInterface contains the requested interface pointer.

Return Value

This function can return the following values.

Return code Description
S_OK
The context was retrieved successfully.
E_NOINTERFACE
The call context does not support the interface specified by riid.

Remarks

CoGetCallContext retrieves the context of the current call on the current thread. The riid parameter specifies the interface on the context to be retrieved. This is one of the functions provided to give the server access to any contextual information of the caller.

Requirements

   
Windows version Windows 2000 Professional [desktop apps only] Windows 2000 Server [desktop apps only]
Target Platform Windows
Header combaseapi.h (include Objbase.h)
Library Ole32.lib
DLL Ole32.dll

See Also

IServerSecurity

Security in COM