COM
Expand Minimize

CoGetCallContext function

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

Syntax


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

Parameters

riid [in]

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 [out]

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 codeDescription
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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Objbase.h

Library

Ole32.lib

DLL

Ole32.dll

See also

IServerSecurity
Security in COM

 

 

Community Additions

ADD
Show:
© 2014 Microsoft