IContinuation Interface

Encapsulates a method call. The object represents a method call, either local or remote, on client or server that is running, future, or completed.

C type for interface pointer:

Extends IHeap

Implemented by CContinuation

Methods: Wait Complete SetBuffer SetMethod Execute SendMessage

Methods

Wait

Block waiting for this continuation to complete.

Complete

Notify that continuation has completed.

Consumes reference on this (does internal Release).

SetBuffer

Provide a memory buffer for continuation tmp heap.

SetMethod

Prepare for activation.

Execute

Run continuation locally.

SendMessage

Create and send message as appropriate: 1) local calls, do nothing; 2) client, send request; 3) RPC server, send reply; 4) one-way server, do nothing.

IContinuation.Wait Method

Block waiting for this continuation to complete.

SCODE Wait( 
    /*in,this*/ PICONTINUATION iThis)

Returns S_OK if the method is successful, otherwise an error code.

C++

SCODE IContinuation::Wait( void )

IContinuation.Complete Method

Notify that continuation has completed.

Consumes reference on this (does internal Release).

SCODE Complete( 
    /*in,this*/ PICONTINUATION iThis)

Returns S_OK if the method is successful, otherwise an error code.

C++

SCODE IContinuation::Complete( void )

IContinuation.SetBuffer Method

Provide a memory buffer for continuation tmp heap.

SCODE SetBuffer( 
    /*in,this*/ PICONTINUATION iThis,
    /*in*/ PTR Where,
    /*in*/ UINT sizeis)

Returns S_OK if the method is successful, otherwise an error code.

Where: The address of the memory.
sizeis: The size of the buffer.

C++

SCODE IContinuation::SetBuffer( 
    /*in*/ PTR Where,
    /*in*/ UINT sizeis)

IContinuation.SetMethod Method

Prepare for activation.

SCODE SetMethod( 
    /*in,this*/ PICONTINUATION iThis,
    /*in*/ CPXMLNAMESPACE Xns,
    /*in*/ const void * metd,
    /*in,optional*/ const _TCHAR * objname,
    /*in,optional*/ PIUNKNOWN pObj)

Returns S_OK if the method is successful, otherwise an error code.

Xns: Namespace of method.
metd: Descriptor for method (CPMETHOD_DESCR).
objname: Path of object in system namespace.
pObj: The object to be called. One and only one of objname and pObj should be present.

C++

SCODE IContinuation::SetMethod( 
    /*in*/ CPXMLNAMESPACE Xns,
    /*in*/ const void * metd,
    /*in,optional*/ const _TCHAR * objname,
    /*in,optional*/ PIUNKNOWN pObj)

IContinuation.Execute Method

Run continuation locally.

SCODE Execute( 
    /*in,this*/ PICONTINUATION iThis,
    /*in*/ BOOL sync,
    /*in,optional*/ void* pRes)

Returns S_OK if the method is successful, otherwise an error code.

sync: TRUE: Execute synchronously using current thread. FALSE: Execute asynchronously using another thread.
pRes: Reservation to use. When NULL a suitable reservation will be searched for.

C++

SCODE IContinuation::Execute( 
    /*in*/ BOOL sync,
    /*in,optional*/ void* pRes)

IContinuation.SendMessage Method

Create and send message as appropriate: 1) local calls, do nothing; 2) client, send request; 3) RPC server, send reply; 4) one-way server, do nothing.

SCODE SendMessage( 
    /*in,this*/ PICONTINUATION iThis,
    /*in,optional*/ PIHTTPCONNECTOR pConn,
    /*in,optional*/ PCode pFaultCode,
    /*in,optional*/ const _TCHAR * FaultString)

Returns S_OK if the method is successful, otherwise an error code.

pConn: Connector where to send the message or NULL.
pFaultCode: Optional FaultCode (soap:Code). When given, a fault is sent in lieue of the regular response message. On the client this parameter is ignored.
FaultString: Optional text that goes along with pFaultCode.

C++

SCODE IContinuation::SendMessage( 
    /*in,optional*/ PIHTTPCONNECTOR pConn,
    /*in,optional*/ PCode pFaultCode,
    /*in,optional*/ const _TCHAR * FaultString)