Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IContextCallback::ContextCallback method

Enters the object context, executes the specified function, and returns.

Syntax


HRESULT ContextCallback(
  [in] PFNCONTEXTCALL pfnCallback,
  [in] ComCallData    *pParam,
  [in] REFIID         riid,
  [inint            iMethod,
  [in] IUnknown       *pUnk
);

Parameters

pfnCallback [in]

The function to be called inside the object context.

pParam [in]

The data to be passed to the function when it is called in the context.

riid [in]

The IID of the call that is being simulated. See Remarks for more information.

iMethod [in]

The method number of the call that is being simulated. See Remarks for more information.

pUnk [in]

This parameter is reserved and must be NULL.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL. If none of these failures occur, the return value of this function is the HRESULT value returned by the pfnCallback function.

Remarks

This method simulates a method call on an object inside the context. It is intended for low-level operations, such as cleanup/lazy marshaling, that respect the application's reentrancy expectations.

To give the infrastructure information, an interface and method number must be specified. The parameter riid must not be IID_IUnknown, and the method number must not be less than 3.

If riid is set to IID_IEnterActivityWithNoLock, the function is executed without an activity lock.

If riid is set to IID_ICallbackWithNoReentrancyToApplicationSTA, the function does not reenter an ASTA arbitrarily. Most apps should set riid to this values for general purpose use.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Header

Ctxtcall.h

IDL

Ctxtcall.idl

IID

IID_IContextCallback is defined as 000001da-0000-0000-C000-000000000046

See also

IContextCallback

 

 

Show:
© 2017 Microsoft