windows-nt/Source/XPSP1/NT/com/rpc/runtime/mtrt/osfclnt.hxx

/*++

Copyright (C) Microsoft Corporation, 1991 - 1999

Module Name:

    osfclnt.hxx

Abstract:

    This file contains the client side classes for the OSF connection
    oriented RPC protocol engine.

Author:

    Michael Montague (mikemon) 17-Jul-1990

Revision History:
    Mazhar Mohammed (mazharm) 11-08-1996 - Major re-haul to support async
      - Added support for Async RPC, Pipes
      - Changed class structure
    Kamen Moutafov      (kamenm)    Jan-2000    Support for multiple transfer syntaxes
    Kamen Moutafov (KamenM) Dec 99 - Feb 2000 - Support for cell debugging stuff
--*/

#ifndef __OSFCLNT_HXX__
#define __OSFCLNT_HXX__

enum OSF_CCALL_STATE
{
    //
    // Need to open the connection and bind, in order to
    // handle the call
    //
    NeedOpenAndBind = 0,

    //
    // Need to send an alter context on the connection
    // in order to handle this call
    //
    NeedAlterContext,

    //
    // We sent an alter-context, we are waiting for a reply
    //
    WaitingForAlterContext,

    //
    // The call is still sending the non pipe data
    // we need to finish sending this before
    // we can move on the the next call.
    //
    SendingFirstBuffer,

    //
    // The call is now sending pipe data
    //
    SendingMoreData,

    //
    // The the call is done sending data. It is now waiting for a reply.
    // The reply may be either a response or a callback.
    //
    WaitingForReply,

    //
    // The call is receiving a callback from the server
    //
    InCallbackRequest,

    //
    // The call is in the process of sending a reply to a callback
    //
    InCallbackReply,

    //
    // We move into this state after receiving the first fragment
    //
    Receiving,

    //
    // Some failure occured. the call is now in an
    // aborted state
    //
    Aborted,

    //
    // The call is complete
    //
    Complete
} ;

//
// Maximum retries in light of getting a shutdown
// or closed in doing a bind or shutdown
//
#define MAX_RETRIES  3

// 15 min timeout for bind
#define RPC_C_SERVER_BIND_TIMEOUT               15*60*1000

//
// These values specify the minimum amount of time in milliseconds to wait before
// deleting an idle connection. The second is the more aggressive. It will be used
// when we have more than 500 connections in an association
//

const ULONG AGGRESSIVE_TIMEOUT_THRESHOLD = 500;

const ULONG CLIENT_DISCONNECT_TIME1 = 10 * 1000;
const ULONG CLIENT_DISCONNECT_TIME2 = 5 * 1000;

#define InqTransCConnection(RpcTransportConnection) \
    ((OSF_CCONNECTION *) \
            ((char *) RpcTransportConnection - sizeof(OSF_CCONNECTION)))

#define TransConnection() ((RPC_TRANSPORT_CONNECTION) \
                                       ((char *) this+sizeof(OSF_CCONNECTION)))
#define TransResolverHint() ((void *) ((char *) this+sizeof(OSF_CASSOCIATION)))

class OSF_CASSOCIATION;
class OSF_CCONNECTION ;
class OSF_BINDING ;
class OSF_CCALL ;

extern MUTEX *AssocDictMutex;


class OSF_RECURSIVE_ENTRY
/*++

Class Description:

    This class is used to describe the entries in the dictionary of
    recursive calls maintained by each binding handle.

Fields:

    Thread - Contains the thread owning this recursive call.

    RpcInterfaceInformation - Contains information describing the
        interface

    CCall - Contains the call

--*/
{
friend class OSF_BINDING_HANDLE;
private:

    THREAD_IDENTIFIER Thread;
    PRPC_CLIENT_INTERFACE RpcInterfaceInformation;
    OSF_CCALL * CCall;

public:

    OSF_RECURSIVE_ENTRY (
        IN THREAD_IDENTIFIER Thread,
        IN PRPC_CLIENT_INTERFACE RpcInterfaceInformation,
        IN OSF_CCALL * CCall
        );

    OSF_CCALL *
    IsThisMyRecursiveCall (
        IN THREAD_IDENTIFIER Thread,
        IN PRPC_CLIENT_INTERFACE RpcInterfaceInformation
        );
};


inline
OSF_RECURSIVE_ENTRY::OSF_RECURSIVE_ENTRY (
    IN THREAD_IDENTIFIER Thread,
    IN PRPC_CLIENT_INTERFACE RpcInterfaceInformation,
    IN OSF_CCALL * CCall
    )
/*++

Routine Description:

    All we do in this constructor is stash the arguments passed to us
    away in the object.

Arguments:

    Thread - Supplies the thread for which this is the recursive call.

    RpcInterfaceInformation - Supplies information describing the
        interface

    CCall - Supplies the recursive call.

--*/
{
    this->Thread = Thread;
    this->RpcInterfaceInformation = RpcInterfaceInformation;
    this->CCall = CCall;
}


inline OSF_CCALL *
OSF_RECURSIVE_ENTRY::IsThisMyRecursiveCall (
    IN THREAD_IDENTIFIER Thread,
    IN PRPC_CLIENT_INTERFACE RpcInterfaceInformation
    )
/*++

Routine Description:

    This routine determines if this object contains the recursive call
    for the specified thread and interface information.

Arguments:

    Thread - Supplies the thread.

    RpcInterfaceInformation - Supplies the interface information.

Return Value:

    If this object contains the recursive call corresponding to the
    specified thread and interface information, then the connection is
    returned.  Otherwise, zero will be returned.

--*/
{
    return((((Thread == this->Thread)
            && (RpcInterfaceInformation == this->RpcInterfaceInformation))
             ? CCall : 0));
}

NEW_SDICT(OSF_RECURSIVE_ENTRY);


class RPC_TOKEN
{
public:
    HANDLE hToken;
    LUID ModifiedId;
    int RefCount;
    int Key;

    RPC_TOKEN (HANDLE hToken, LUID *pModifiedId)
    {
        this->hToken = hToken;
        RefCount = 1;
        FastCopyLUIDAligned(&ModifiedId, pModifiedId);
    }

    ~RPC_TOKEN ()
    {
        CloseHandle(hToken);
    }
};



class OSF_BINDING_HANDLE : public BINDING_HANDLE
/*++

Class Description:

    Client applications use instances (referenced via an RPC_BINDING_HANDLE)
    of this class to make remote procedure calls.

Fields:

    Association - Contains a pointer to the association used by this
        binding handle.  The association can allocate connection for
        making remote procedure calls.  Before the first remote procedure
        call is made using this binding handle, the Association will
        be zero.  When the first remote procedure call is made, an
        assocation will be found or created for use by this binding handle.

    DceBinding - Before the first remote procedure call for this binding
        handle, this will contain the DCE binding information necessary
        to create or find an association to be used by this binding handle.
        After we have an association, this field will be zero.

    TransportInterface - This field is the same as DceBinding, except that
        it points to a rpc client info data structure used for describing
        a loadable transport.

    RecursiveCalls - This is a dictionary of recursive calls indexed
        by thread identifier and rpc interface information.

    BindingMutex - The binding handle can be used by more than one thread
        at a time.  Hence, we need to serialize access to the object;
        we use this mutex for that.

    ReferenceCount - We count the number of active connections and the
        application RPC_BINDING_HANDLE which point at this object.  This
        is so that we know when to free it.

--*/
{
friend class OSF_CCALL;

private:

    OSF_CASSOCIATION * Association;
    DCE_BINDING * DceBinding;
    TRANS_INFO *TransInfo ;
    OSF_RECURSIVE_ENTRY_DICT RecursiveCalls;
    UINT ReferenceCount;
    RPC_TOKEN *pToken;

public:
    // set for Remote named pipes only
    BOOL fNamedPipe;
    BOOL TransAuthInitialized;
    BOOL fDynamicEndpoint;

    OSF_BINDING_HANDLE (
        IN OUT RPC_STATUS  * RpcStatus
        );

    ~OSF_BINDING_HANDLE (
        );

    virtual RPC_STATUS
    NegotiateTransferSyntax (
        IN OUT PRPC_MESSAGE Message
        );

    virtual RPC_STATUS
    GetBuffer (
        IN OUT PRPC_MESSAGE Message,
        IN UUID *ObjectUuid
        );

    virtual RPC_STATUS
    BindingCopy (
        OUT BINDING_HANDLE *  * DestinationBinding,
        IN UINT MaintainContext
        );

    virtual RPC_STATUS
    BindingFree (
        );

    virtual RPC_STATUS
    PrepareBindingHandle (
        IN TRANS_INFO  * TransportInterface,
        IN DCE_BINDING * DceBinding
        );

    virtual RPC_STATUS
    ToStringBinding (
        OUT RPC_CHAR  *  * StringBinding
        );

    virtual RPC_STATUS
    ResolveBinding (
        IN RPC_CLIENT_INTERFACE  * RpcClientInterface
        );

    virtual RPC_STATUS
    BindingReset (
        );

    virtual RPC_STATUS
    InquireTransportType(
        OUT UINT  *Type
        )
    { *Type = TRANSPORT_TYPE_CN; return(RPC_S_OK); }

    virtual ULONG
    MapAuthenticationLevel (
        IN ULONG AuthenticationLevel
        );

    virtual void
    AddReference (
        )
        {
        BindingMutex.Request();
        ReferenceCount++;
        BindingMutex.Clear();
        }

    RPC_STATUS
    AllocateCCall (
        OUT OSF_CCALL  *  * CCall,
        IN PRPC_MESSAGE Message,
        OUT BOOL *Retry
        );

    RPC_STATUS
    AddRecursiveEntry (
        IN OSF_CCALL * CCall,
        IN PRPC_CLIENT_INTERFACE RpcInterfaceInformation
        );

    void
    RemoveRecursiveCall (
        IN OSF_CCALL * CCall
        );

    OSF_CASSOCIATION *
    TheAssociation (
        ) {return(Association);}

    OSF_CASSOCIATION *
    FindOrCreateAssociation (
        IN DCE_BINDING * DceBinding,
        IN TRANS_INFO * TransInfo,
        IN RPC_CLIENT_INTERFACE *InterfaceInfo
        );

    RPC_STATUS
    AcquireCredentialsForTransport (
        );

    BOOL
    SwapToken (
        HANDLE *OldToken
        );

    void Unbind ();

    virtual RPC_STATUS
    SetTransportOption( unsigned long option,
                        ULONG_PTR     optionValue );

    virtual RPC_STATUS
    InqTransportOption( unsigned long  option,
                        ULONG_PTR    * pOptionValue );
};

const unsigned int BindingListPresent = 1;

class OSF_CCONNECTION ;
enum CANCEL_STATE {
 CANCEL_NOTREGISTERED = 0,
 CANCEL_INFINITE,
 CANCEL_NOTINFINITE
 };

class OSF_CCALL : public CCALL
/*++

Class Description:
        This class encapsulates an RPC call.

Fields:

    PresentationContext - This field is only valid when there is a remote
        procedure call in progress on this connection; it contains the
        presentation context for the call.

    DispatchTableCallback - This field is only valid when there is a remote
        procedure call in progress on this connection; it contains the
        dispatch table to use for callbacks.

    Association - Contains a pointer to the association which owns this
        connection.

    TokenLength - Contains the maximum size of a token for the security
        package being used by this connection; we need to keep track of
        this for the third leg authentication case.

--*/
{

//
// This class will only access the AssociationKey member.
//

friend class OSF_CASSOCIATION;
friend class OSF_CCONNECTION;
friend class OSF_BINDING_HANDLE;

public:
    OSF_CCALL_STATE CurrentState ;

private:
    OSF_CCONNECTION *Connection ;
    OSF_BINDING_HANDLE *BindingHandle;
#ifdef DEBUGRPC
    int CallbackLevel;
#endif

    // don't access the struct members directly - only through
    // the access functions - this will ensure that the
    // contents of the struct is properly checked. Async first
    // calls on new connection have both elements valid if there
    // are no preferences. Since this is the only case where
    // this condition is true, we can use it as a flag.
    struct
        {
        // NULL if no binding is selected
        OSF_BINDING *SelectedBinding;

        // this is the list of differning only by transfer syntax
        // bindings this call can use. It can have one or more
        // elements.
        // This may be NULL if the call doesn't need a list
        OSF_BINDING *AvailableBindingsList;
        } Bindings;

    void *CurrentBuffer ;
    BOOL fDataLengthNegotiated;
    int CurrentOffset ;
    ULONG CurrentBufferLength ;
    ULONG CallId;
    UINT RcvBufferLength ;
    BOOL FirstSend ;
    PRPC_DISPATCH_TABLE DispatchTableCallback;
    UINT MaximumFragmentLength;

    // starts from 0, and set to non-zero if security is used after
    // negotiating the bind
    UINT MaxSecuritySize ;
    UINT MaxDataLength;
    int ProcNum ;
    unsigned char  *ReservedForSecurity ;
    UINT SecBufferLength;

    // When the call is created, set to 0, because we don't know whether
    // there is object UUID or not. During GetBuffer we will know, and then
    // we will set it properly. Starting from 0 allows the bind and GetBuffer 
    // threads (if different) to check and to synchronize the updating of the
    // max fragment size, since it depends both on the object UUID and
    // the security negotiation
    UINT HeaderSize;
    UINT AdditionalSpaceForSecurity;
    ULONG SavedHeaderSize;
    void  *   SavedHeader;
    void  * LastBuffer ;
    EVENT SyncEvent ;
    UINT ActualBufferLength;
    UINT NeededLength;
    void  *CallSendContext;
    INTERLOCKED_INTEGER fAdvanceCallCount;
    BOOL fPeerChoked;

    // Extended Error Info stuff
    // used in async calls only to hold
    // information b/n call failure and 
    // RpcAsyncCompleteCall
    ExtendedErrorInfo *EEInfo;

    BOOL fDoFlowControl;
public:
    BOOL fLastSendComplete;
    MUTEX CallMutex ;
    int RecursiveCallsKey;

    //
    // Indicates the call stack.  Whenever a request message is sent or
    // received, the stack is incremented.  Likewise, whenever a response
    // message is sent or received, the stack is decremented.
    //
    int CallStack;
    BOOL fCallCancelled;
    CANCEL_STATE CancelState;

private:
    QUEUE BufferQueue ;
    BOOL InReply;
    BOOL fChoked;

    OSF_CCALL (
        RPC_STATUS  * pStatus
        );

public:

    virtual~OSF_CCALL (
        );

    virtual RPC_STATUS
    NegotiateTransferSyntax (
        IN OUT PRPC_MESSAGE Message
        );

    virtual RPC_STATUS
    GetBuffer (
        IN OUT PRPC_MESSAGE Message,
        IN UUID *ObjectUuid = 0
        );

    RPC_STATUS 
    GetBufferWithoutCleanup (
        IN OUT PRPC_MESSAGE Message,
        IN UUID *ObjectUuid
        );

    virtual RPC_STATUS
    SendReceive (
        IN OUT PRPC_MESSAGE Message
        );

    RPC_STATUS
    SendReceiveHelper (
       IN OUT PRPC_MESSAGE Message,
       OUT BOOL *fRetry
       );

    virtual RPC_STATUS
    Send (
        IN PRPC_MESSAGE Message
        );

    virtual RPC_STATUS
    Receive (
        IN PRPC_MESSAGE Message,
        IN UINT Size
        );

    virtual void
    FreeBuffer (
        IN PRPC_MESSAGE Message
        );

    virtual void
    FreePipeBuffer (
        IN PRPC_MESSAGE Message
        );

    virtual RPC_STATUS
    ReallocPipeBuffer (
        IN PRPC_MESSAGE Message,
        IN UINT NewSize
        );

    virtual RPC_STATUS
    AsyncSend (
        IN OUT PRPC_MESSAGE Message
        );

    virtual RPC_STATUS
    AsyncReceive (
        IN OUT PRPC_MESSAGE Message,
        IN UINT Size
        );

    virtual void
    ProcessSendComplete (
        IN RPC_STATUS EventStatus,
        IN BUFFER Buffer
        );

    virtual RPC_STATUS
    CancelAsyncCall (
        IN BOOL fAbort
        );

    virtual void
    FreeObject (
        );

    RPC_STATUS
    SendHelper (
        IN PRPC_MESSAGE Message,
        OUT BOOL *fFirstSend
        );

    RPC_STATUS
    SendData (
        IN BUFFER Buffer
        );

    RPC_STATUS
    SendMoreData (
        IN BUFFER Buffer
        );

    RPC_STATUS
    ActuallyAllocateBuffer (
        OUT void  *  * Buffer,
        IN UINT BufferLength
        );

    void
    ActuallyFreeBuffer (
        IN void  * Buffer
        );

    //
    // Actually perform the buffer allocation.
    //
    RPC_STATUS
    GetBufferDo (
        IN UINT culRequiredLength,
        OUT void  * * ppBuffer,
        IN int fDataValid = 0,
        IN int DataLength = 0
        );

    void
    FreeBufferDo (
        IN void  *Buffer
        );

    RPC_STATUS
    ActivateCall (
        IN OSF_BINDING_HANDLE *BindingHandle,
        IN OSF_BINDING *Binding,
        IN OSF_BINDING *AvailableBindingsList,
        IN ULONG CallIdToUse,
        IN OSF_CCALL_STATE InitialCallState,
        IN PRPC_DISPATCH_TABLE DispatchTable,
        IN OSF_CCONNECTION *CConnection
        );

    void
    FreeCCall (
        IN RPC_STATUS Status
        );

    RPC_STATUS
    SendCancelPDU(
        );

    RPC_STATUS
    SendOrphanPDU (
        );

    RPC_STATUS
    BindToServer (
        BOOL fAsyncBind
        );

    RPC_STATUS
    Cancel(
        void * ThreadHandle
        );

    RPC_STATUS 
    InqWireIdForSnego (
        OUT unsigned char *WireId
        );

    RPC_STATUS 
    BindingHandleToAsyncHandle (
        OUT void **AsyncHandle
        );

    // if fMultipleBindingsAvailable is set, the return value is a head of a linked
    // list. If fMultipleBindingsAvailable is FALSE, only the element in the return 
    // value is meaningful
    inline OSF_BINDING *
    GetListOfAvaialbleBindings (
        OUT BOOL *fMultipleBindingsAvailable
        )
    {
        if (Bindings.AvailableBindingsList)
            {
            *fMultipleBindingsAvailable = TRUE;
            return Bindings.AvailableBindingsList;
            }
        else
            {
            *fMultipleBindingsAvailable = FALSE;
            return Bindings.SelectedBinding;
            }
    }

    RPC_STATUS 
    BindCompleteNotify (
        IN p_result_t *OsfResult, 
        IN int IndexOfPresentationContextAccepted,
		OUT OSF_BINDING **BindingNegotiated
        );

#ifdef DEBUGRPC
    inline void EnterCallback(void)
    {
        CallbackLevel ++;
    }

    inline void ExitCallback(void)
    {
        CallbackLevel --;
    }

    inline BOOL IsCallInCallback(void)
    {
        return CallbackLevel > 0;
    }
#endif

private:
    void
    SendFault (
        IN RPC_STATUS Status,
        IN int DidNotExecute
        );

#define MAX_ALLOC_Hint 16*1024

    RPC_STATUS
    EatAuthInfoFromPacket (
        IN rpcconn_request  * Request,
        IN OUT UINT  * RequestLength
        );

    BOOL
    ProcessReceivedPDU (
        IN void *Buffer,
        IN int BufferLength
        );

    RPC_STATUS
    GetCoalescedBuffer (
        IN PRPC_MESSAGE Message,
        IN BOOL BufferValid
        );

    RPC_STATUS
    SendAlterContextPDU (
        );

    RPC_STATUS
    GetCoalescedBuffer(
        IN PRPC_MESSAGE Message);

    RPC_STATUS
    FastSendReceive (
        IN OUT PRPC_MESSAGE Message,
        OUT BOOL *fRetry
        );

    RPC_STATUS
    SendNextFragment (
        IN unsigned char PacketType = rpc_request,
        IN BOOL fFirstSend = TRUE,
        OUT void **ReceiveBuffer = 0,
        OUT UINT *ReceivedLength = 0
        );

    RPC_STATUS
    ActuallyProcessPDU (
        IN rpcconn_common *Packet,
        IN UINT PacketLength,
        IN OUT PRPC_MESSAGE Message,
        IN BOOL fAsync = 0,
        OUT BOOL *pfSubmitReceive = NULL
        );

    RPC_STATUS
    ProcessResponse (
        IN rpcconn_response *Packet,
        IN PRPC_MESSAGE Message,
        OUT BOOL *pfSubmitReceive
        );

    RPC_STATUS
    ProcessRequestOrResponse (
        IN rpcconn_request *Request,
        IN UINT PacketLength,
        IN BOOL fRequest,
        IN PRPC_MESSAGE Message
        );

    RPC_STATUS
    DealWithCallback (
        IN rpcconn_request *Request,
        IN PRPC_MESSAGE Message
        );

    RPC_STATUS
    ReceiveReply (
        IN rpcconn_request *Request,
        IN PRPC_MESSAGE Message
        );

    void
    CallFailed (
        IN RPC_STATUS Status
        ) ;

    int
    QueueBuffer (
        IN void *Buffer,
        IN int BufferLength);

    BOOL
    IssueNotification (
        IN RPC_ASYNC_EVENT Event = RpcCallComplete
        );

    RPC_STATUS ReserveSpaceForSecurityIfNecessary (void);

    void UpdateObjectUUIDInfo (IN UUID *ObjectUuid);

    void UpdateMaxFragLength (const IN ULONG AuthnLevel);

    RPC_STATUS AutoRetryCall(IN OUT RPC_MESSAGE *Message, IN BOOL fSendReceivePath,
        IN OSF_BINDING_HANDLE *LocalBindingHandle, IN RPC_STATUS CurrentStatus,
        IN RPC_ASYNC_STATE *AsyncState OPTIONAL);

    void CleanupOldCallOnAutoRetry(IN PVOID Buffer, IN BOOL fSendReceivePath, 
        IN RPC_STATUS CurrentStatus)
    {
        FreeBufferDo(Buffer);

        if (fSendReceivePath)        
            FreeCCall(CurrentStatus);
        else
            {
            //
            // Remove the call reference, CCALL--
            //
            RemoveReference();
            }        
    }

    OSF_BINDING *GetSelectedBinding(void)
    {
        ASSERT(Bindings.SelectedBinding != NULL);
        return Bindings.SelectedBinding;
    }

    OSF_BINDING *GetBindingList(void)
    {
        ASSERT(Bindings.AvailableBindingsList != NULL);
        return Bindings.AvailableBindingsList;
    }

    void *
    ActualBuffer (
        IN void *Buffer
        );

    RPC_STATUS
    CallCancelled (
        OUT PDWORD Timeout
        );

    RPC_STATUS
    RegisterCallForCancels (
        );

    void
    UnregisterCallForCancels (
        );

    void * operator new (
        size_t allocBlock,
        unsigned int xtraBytes
        );

    RPC_STATUS
    UpdateBufferSize (
       IN OUT void **Buffer,
       IN int CurrentBufferLength
       );

    inline BOOL
    fOkToAdvanceCall()
    {
        return (fAdvanceCallCount.Increment() == 2);
    }

    virtual RPC_STATUS
    InqSecurityContext (
        OUT void **SecurityContextHandle
        );

    static RPC_STATUS 
    NegotiateTransferSyntaxAndGetBuffer (
        IN OUT PRPC_MESSAGE Message,
        IN UUID *ObjectUuid
        );

    inline ULONG
    GetBindingHandleTimeout (
        IN OSF_BINDING_HANDLE *BindingToUse
        )
    {
        RPC_STATUS RpcStatus;
        ULONG_PTR OptionValue;

        RpcStatus = BindingToUse->OSF_BINDING_HANDLE::InqTransportOption(
            RPC_C_OPT_CALL_TIMEOUT,
            &OptionValue);

        ASSERT(RpcStatus == RPC_S_OK);

        if (OptionValue == 0)
            return INFINITE;
        else
            return (ULONG) OptionValue;
    }

    inline RPC_STATUS
    GetStatusForTimeout (
        IN OSF_BINDING_HANDLE *BindingHandleToUse,
        IN RPC_STATUS Status,
        BOOL fBindingHandleTimeoutUsed
        )
    {
        if (Status == RPC_P_TIMEOUT)
            {
            if (fBindingHandleTimeoutUsed)
                {
                Status = RPC_S_CALL_CANCELLED;
                RpcpErrorAddRecord(EEInfoGCRuntime,
                    Status,
                    EEInfoDLGetStatusForTimeout10,
                    RPC_P_TIMEOUT,
                    GetBindingHandleTimeout(BindingHandle));
                }
            else
                {
                Status = RPC_S_CALL_FAILED_DNE;
                RpcpErrorAddRecord(EEInfoGCRuntime,
                    Status,
                    EEInfoDLGetStatusForTimeout20,
                    (ULONG)RPC_P_TIMEOUT,
                    (ULONG)RPC_C_SERVER_BIND_TIMEOUT);
                }
            }

        return Status;
    }

    inline ULONG
    GetEffectiveTimeoutForBind (
        IN OSF_BINDING_HANDLE *BindingToUse,
        OUT BOOL *fBindingHandleTimeoutUsed
        )
    {
        ULONG Timeout;

        Timeout = GetBindingHandleTimeout(BindingToUse);
        if (Timeout > RPC_C_SERVER_BIND_TIMEOUT)
            {
            Timeout = RPC_C_SERVER_BIND_TIMEOUT;
            *fBindingHandleTimeoutUsed = FALSE;
            }
        else
            {
            *fBindingHandleTimeoutUsed = TRUE;
            }

        return Timeout;
    }
};

inline void *
OSF_CCALL::operator new (
        size_t allocBlock,
        unsigned int xtraBytes
        )
{
    I_RPC_HANDLE pvTemp = (I_RPC_HANDLE) new char[allocBlock + xtraBytes];

    return(pvTemp);
}

inline void
OSF_CCALL::FreeObject (
    )
{
    if (AsyncStatus == RPC_S_ASYNC_CALL_PENDING)
        {
        AsyncStatus = RPC_S_CALL_FAILED;
        }

    FreeCCall(AsyncStatus);
}

inline RPC_STATUS
OSF_CCALL::RegisterCallForCancels (
    )
{
    RPC_STATUS Status;

    if (pAsync == 0)
        {
        Status = RegisterForCancels(this);
        if (Status != RPC_S_OK)
            {
            return Status;
            }

        if (ThreadGetRpcCancelTimeout() == RPC_C_CANCEL_INFINITE_TIMEOUT)
            {
            CancelState = CANCEL_INFINITE;
            }
        else
            {
            CancelState = CANCEL_NOTINFINITE;
            }
        }
    return RPC_S_OK;
}

inline void
OSF_CCALL::UnregisterCallForCancels (
    )
{
    if (pAsync == 0)
        {
        EVAL_AND_ASSERT(RPC_S_OK == UnregisterForCancels());
        }
}


inline void *
OSF_CCALL::ActualBuffer (
    IN void *Buffer
    )
{
    ASSERT (HeaderSize != 0);
    if (UuidSpecified)
        {
        Buffer = (char  *) Buffer  - sizeof(rpcconn_request) - sizeof(UUID);
        }
    else
        {
        Buffer = (char  *) Buffer  - sizeof(rpcconn_request);
        }

    return Buffer;
}

inline int
OSF_CCALL::QueueBuffer (
    IN void *Buffer,
    IN int BufferLength
    )
{
   RcvBufferLength += BufferLength;

   return BufferQueue.PutOnQueue(Buffer, BufferLength);
}

NEW_SDICT2(OSF_CCALL, PVOID);

#define SYNC_CONN_FREE 0
#define SYNC_CONN_BUSY -1
#define ASYNC_CONN_BUSY -2
#define ASYNC_CONN_FREE -3

enum CONNECTION_STATES
{
    ConnUninitialized,
    ConnAborted,
    ConnOpen
};

const unsigned int FreshFromCache = 1;

enum FAILURE_COUNT_STATE
{
    FailureCountUnknown,
    FailureCountNotExceeded,
    FailureCountExceeded
};


class OSF_CCONNECTION : public REFERENCED_OBJECT
/*++

Class Description:
        This class encapsulates a transport connection. The transport
        connection may be used by one or more RPC calls. Each RPC
        call is encapsulated by an CALL object. This object may
        be exclusively used by a call. Each connection is owned by
        exacly one thread (ie: all calls on a connection have been
        initiated by a single thread).

Fields:
        Association: Pointer to the association object

        ConnectionKey: Key to our entry in the dictionary of connections in
                the association.

        ThreadId: Thread Id of the thread owning this call.

        DceSecurityInfo - Contains information necessary for DCE security to
        work properly.  This includes the association uuid (a different
        value for each connection), and sequence numbers (both directions).

        ThirdLegAuthNeeded - Contains a flag indicating whether or not third
        leg authentication is needed; a non-zero value indicates that it
        is needed.

        ClientSecurityContext - Optionally contains the security context being
        used for this connection.

        AdditionalSpaceForSecurity - Contains the amount of space to save
        for security in each buffer we allocate.

        LastTimeUsed - Contains the time in seconds when this connection was
        last used.

        CurrentCall - The call on which we are currently **sending** data

        ClientInfo - Contains the pointers to the loadable transport routines
        for the transport type of this connection.

        fConnectionAborted - If this field is non-zero it indicates that the
        connection has been aborted, meaning that any attempts to send
        or receive data on the connection will fail.

--*/
{
friend class OSF_CASSOCIATION;
friend class OSF_CCALL;
friend class OSF_BINDING_HANDLE;

private:
    OSF_CASSOCIATION * Association;
    OSF_CCALL *CurrentCall ;
    int  ConnectionKey;
    CONNECTION_STATES State;
    unsigned char WireAuthId;
    unsigned short MaxFrag;
    ULONG ThreadId ;
    BOOL CachedCCallAvailable ;
    ULONG MaxSavedHeaderSize;
    OSF_CCALL *CachedCCall ;
    ULONG SavedHeaderSize;
    unsigned int ComTimeout ;
    void  *   SavedHeader;
    BOOL AdditionalLegNeeded;
    ULONG LastTimeUsed;
    UINT TokenLength;
    UINT AdditionalSpaceForSecurity;
    BOOL fIdle ;
    BOOL fExclusive ;
    BOOL fConnectionAborted;
    CompositeFlags Flags;

    BITSET Bindings;
    QUEUE CallQueue ;
    MUTEX ConnMutex ;
    OSF_CCALL_DICT2 ActiveCalls ;
    SECURITY_CONTEXT ClientSecurityContext;

    RPC_CONNECTION_TRANSPORT * ClientInfo;
    union
        {
        void *ConnSendContext ;
        OSF_CCONNECTION *NextConnection;     // used to link connections in some case
        } u;

    DCE_SECURITY_INFO DceSecurityInfo;

    void *BufferToFree;
    BOOL ConnectionReady;
    BOOL fSeparateConnection;

public:
    OSF_CCONNECTION (
        IN OSF_CASSOCIATION *Association,
        IN RPC_CONNECTION_TRANSPORT * RpcClientInfo,
        IN unsigned int Timeout,
        IN CLIENT_AUTH_INFO * myAuthInfo,
        IN BOOL fExclusive,
        IN BOOL fSeparateConnection,
        OUT RPC_STATUS  * pStatus
        );

    virtual ~OSF_CCONNECTION (
        );

    virtual void
    ProcessSendComplete (
        IN RPC_STATUS EventStatus,
        IN BUFFER Buffer
        );

    RPC_STATUS
    TransInitialize (
        IN RPC_CHAR *NetworkAddress,
        IN RPC_CHAR *NetworkOptions
        )
    {
        if (ClientInfo->Initialize)
            {
            return ClientInfo->Initialize(TransConnection(), 
                                          NetworkAddress, 
                                          NetworkOptions,
                                          (fExclusive == 0));
            }

        return (RPC_S_OK);
    }

    void
    TransInitComplete (
        )
    {
        if (ClientInfo->InitComplete)
            {
            ClientInfo->InitComplete(TransConnection());
            }
    }

    RPC_STATUS
    TransOpen (
        IN OSF_BINDING_HANDLE * BindingHandle,
        IN RPC_CHAR * RpcProtocolSequence,
        IN RPC_CHAR * NetworkAddress,
        IN RPC_CHAR * Endpoint,
        IN RPC_CHAR * NetworkOptions,
        IN void *ResolverHint,
        IN BOOL fHintInitialized,
        IN ULONG Timeout
        ) ;

    RPC_STATUS
    TransReceive (
        OUT void  *  * Buffer,
        OUT unsigned int  * BufferLength,
        IN ULONG Timeout
        );

    RPC_STATUS
    TransSend (
        IN void  * Buffer,
        IN unsigned int BufferLength,
        IN BOOL fDisableShutdownCheck,
        IN BOOL fDisableCancelCheck,
        IN ULONG Timeout
        );

#ifdef WIN96
    RPC_STATUS
    TransClose (
        );
#endif

    RPC_STATUS
    TransSendReceive (
        IN void  * SendBuffer,
        IN unsigned int SendBufferLength,
        OUT void  *  * ReceiveBuffer,
        OUT unsigned int  * ReceiveBufferLength,
        IN ULONG Timeout
        );

    RPC_STATUS
    TransAsyncSend (
        IN void  * SendBuffer,
        IN unsigned int SendBufferLength,
        IN void  *SendContext
        ) ;

    RPC_STATUS
    TransAsyncReceive (
        ) ;

    RPC_STATUS
    TransPostEvent (
        IN PVOID Context
        ) ;

    void
    TransAbortConnection (
        );

    void
    TransClose (
        );

    unsigned int
    TransMaximumSend (
        );

    unsigned int
    GuessPacketLength (
        );

    void * operator new (
        size_t allocBlock,
        unsigned int xtraBytes
        );

    RPC_STATUS
    TransGetBuffer (
        OUT void  *  * Buffer,
        IN UINT BufferLength
        );

    void
    TransFreeBuffer (
        IN void  * Buffer
        );

    RPC_STATUS
    TransReallocBuffer (
        IN OUT void  *  * Buffer,
        IN UINT OldSize,
        IN UINT NewSize
        );

    RPC_STATUS
    AllocateCCall (
        OUT OSF_CCALL **CCall
        );

    RPC_STATUS
    AddCall (
        IN OSF_CCALL *CCall
        );

    void
    FreeCCall (
        IN OSF_CCALL *CCall,
        IN RPC_STATUS Status,
        IN ULONG ComTimeout
        );

    RPC_STATUS
    OpenConnectionAndBind (
        IN OSF_BINDING_HANDLE *BindingHandle,
        IN ULONG Timeout,
        IN BOOL fAlwaysNegotiateNDR20,
        OUT FAILURE_COUNT_STATE *fFailureCountExceeded OPTIONAL
        );

    RPC_STATUS
    ActuallyDoBinding (
        IN OSF_CCALL *CCall,
        IN ULONG MyAssocGroupId,
        IN BOOL fNewConnection,
        IN ULONG Timeout,
        OUT OSF_BINDING **BindingNegotiated,
        OUT BOOL *fPossibleAssociationReset,
        OUT FAILURE_COUNT_STATE *fFailureCountExceeded OPTIONAL
        );

    RPC_STATUS
    SendBindPacket (
        IN BOOL fInitialPass,
        IN OSF_CCALL *Call,
        IN ULONG AssocGroup,
        IN unsigned char PacketType,
        IN ULONG Timeout,
        IN BOOL fAsync = 1,
        OUT rpcconn_common * * Buffer       = 0,
        OUT UINT           *   BufferLength = 0,
        IN rpcconn_common * InputPacket     = 0,
        IN unsigned int  InputPacketLength  = 0
        );

    RPC_STATUS
    MaybeDo3rdLegAuth (
        IN void  * Buffer,
        IN UINT BufferLength
        );

    //
    // Set the value of the max frag for the connection.
    //
    void
    SetMaxFrag (
        IN unsigned short max_xmit_frag,
        IN unsigned short max_recv_frag
        );

    UINT
    InqMaximumFragmentLength (
        );

    int
    AddPContext (
        IN int PresentContext
        ) {return(Bindings.Insert(PresentContext));}

    void
    DeletePContext (
        IN int PresentContext
        ) {Bindings.Delete(PresentContext);}

    int
    SupportedPContext (
        IN int *PresentationContexts,
        IN int NumberOfPresentationContexts,
        OUT int *PresentationContextSupported
        );

    int
    SupportedAuthInfo (
        IN CLIENT_AUTH_INFO * ClientAuthInfo,
        IN BOOL fNamedPipe
        );

    RPC_STATUS
    SendFragment (
        IN rpcconn_common  *pFragment,
        IN OSF_CCALL *CCall,
        IN UINT LastFragmentFlag,
        IN UINT HeaderSize,
        IN UINT MaxSecuritySize,
        IN UINT DataLength,
        IN UINT MaximumFragmentLength,
        IN unsigned char  *ReservedForSecurity,
        IN BOOL fAsync,
        IN void *SendContext,
        IN ULONG Timeout,
        OUT void **ReceiveBuffer,
        OUT UINT *ReceiveBufferLength
        );

    void
    ProcessReceiveComplete (
        IN RPC_STATUS EventStatus,
        IN BUFFER Buffer,
        IN UINT BufferLength
        );

    ULONG
    InquireSendSequenceNumber (
        );

    ULONG
    InquireReceiveSequenceNumber (
        );

    RPC_CHAR *InqEndpoint(void);

    RPC_CHAR *InqNetworkAddress(void);

    void
    IncSendSequenceNumber (
        );

    inline void
    IncReceiveSequenceNumber (
        );

    void
    NotifyCallDeleted (
        );

    void
    SetLastTimeUsedToNow (
        );

    ULONG
    InquireLastTimeUsed (
        );

    ULONG
    GetAssocGroupId (
        );

    void
    ConnectionAborted (
        IN RPC_STATUS Status,
        IN BOOL fShutdownAssoc = 1
        );

    void
    AdvanceToNextCall (
        );

    RPC_STATUS
    AddActiveCall (
        IN ULONG CallId,
        IN OSF_CCALL *CCall
        );

    RPC_STATUS
    DealWithAlterContextResp (
        IN OSF_CCALL *CCall,
        IN rpcconn_common *Packet,
        IN int PacketLength,
        IN OUT BOOL *AlterContextToNDR20IfNDR64Negotiated
        );

    void
    MakeConnectionIdle (
        );

    void
    MakeConnectionActive (
        );

    BOOL
    IsIdle (
        );

    void
    DeleteConnection (
        );

    BOOL IsExclusive (void)
    {
        return fExclusive;
    }

    RPC_STATUS
    ValidateHeader(
         rpcconn_common * Buffer,
         unsigned long BufferLength
         );

    RPC_STATUS
    FinishSecurityContextSetup (
        IN OSF_CCALL *Call,
        IN unsigned long AssocGroup,
        OUT rpcconn_common * * Buffer,
        OUT unsigned int * BufferLength,
        IN ULONG Timeout
        );

    RPC_STATUS
    CallCancelled (
        OUT PDWORD Timeout
        );

    void
    WaitForSend(
        );

    BOOL
    MatchModifiedId (
        LUID *pModifiedId
        )
    {
        if (ClientSecurityContext.DefaultLogonId)
            {
            return FALSE;
            }

        return (FastCompareLUIDAligned(pModifiedId, &ClientSecurityContext.ModifiedId));
    }

    void
    MaybeAdvanceToNextCall(
        OSF_CCALL *Call
        )
    {
        if (fExclusive == 0
            && CurrentCall == Call)
            {
            AdvanceToNextCall();
            }
    }

    RPC_STATUS
    AbortAndWait (
        OSF_CCALL *Call
        )
    {
        int retval;
        
        // CCONN++
        AddReference();

        //
        // There is still a race condition here
        //
        ConnMutex.Request();
        ActiveCalls.Delete(IntToPtr(Call->CallId));
        ConnMutex.Clear();

        TransAbortConnection();

        //
        // Wait until only the call reference (and the reference added above)
        // remains
        //
        while (RefCount.GetInteger() > 2)
            {
            SleepEx(1, 0);
            }

        ASSERT(IsDeleted());

        TransClose();

        //
        // Ugly hack alert
        //
        SetNotDeleted();

        ConnMutex.Request();
        retval = ActiveCalls.Insert(IntToPtr(Call->CallId), Call);
        ConnMutex.Clear();

        //
        // Don't remove the above reference
        // the connection reference was removed by the thread
        // that did called abort. We are just restoring that reference
        //

        if (retval == -1)
            {
            return RPC_S_OUT_OF_MEMORY;
            }

        return RPC_S_OK;
    }

    inline void SetFreshFromCacheFlag(void)
    {
        Flags.SetFlagUnsafe(FreshFromCache);
    }
    inline void ClearFreshFromCacheFlag(void)
    {
        Flags.ClearFlagUnsafe(FreshFromCache);
    }
    inline BOOL GetFreshFromCacheFlag(void)
    {
        return Flags.GetFlag(FreshFromCache);
    }

    static void
    OsfDeleteIdleConnections (
        void
        );

    RPC_STATUS
    TurnOnOffKeepAlives (
        IN BOOL TurnOn,
        IN ULONG Timeout
        );

private:

    inline void
    InitializeWireAuthId (
        IN CLIENT_AUTH_INFO * ClientAuthInfo
        )
    {
        if (ClientAuthInfo)
            WireAuthId = (unsigned char) ClientAuthInfo->AuthenticationService;
        else
            WireAuthId = RPC_C_AUTHN_NONE;        
    }
};

inline void *
OSF_CCONNECTION::operator new (
        size_t allocBlock,
        unsigned int xtraBytes
        )
{
    I_RPC_HANDLE pvTemp = (I_RPC_HANDLE) new char[allocBlock + xtraBytes];

    return(pvTemp);
}

#pragma optimize ("t", on)
inline void
OSF_CCONNECTION::MakeConnectionIdle (
    )
{
    LogEvent(SU_CCONN, EV_STOP, this, 0, 0, 1);
    fIdle = 1;
}

inline void
OSF_CCONNECTION::MakeConnectionActive (
    )
{
    LogEvent(SU_CCONN, EV_START, this, 0, 0, 1);
    fIdle = 0;
}

inline BOOL
OSF_CCONNECTION::IsIdle (
    )
{
    return fIdle;
}

inline void
OSF_CCONNECTION::NotifyCallDeleted (
    )
{
}

inline void
OSF_CCONNECTION::IncSendSequenceNumber (
    )
{
    DceSecurityInfo.ReceiveSequenceNumber += 1;
}

inline void
OSF_CCONNECTION::IncReceiveSequenceNumber (
    )
{
    DceSecurityInfo.ReceiveSequenceNumber += 1;
}

inline ULONG
OSF_CCONNECTION::InquireSendSequenceNumber (
    )
{
    return DceSecurityInfo.SendSequenceNumber ;
}

inline ULONG
OSF_CCONNECTION::InquireReceiveSequenceNumber (
    )
{
    return DceSecurityInfo.ReceiveSequenceNumber ;
}


inline int
OSF_CCONNECTION::SupportedPContext (
    IN int *PresentationContexts,
    IN int NumberOfPresentationContexts,
    OUT int *PresentationContextSupported
    )
/*++

Return Value:

    Non-zero will be returned if this connection supports the supplied
    presentation context; otherwise, zero will be returned.

--*/
{
    int i;
    int Result;

    for (i = 0; i < NumberOfPresentationContexts; i ++)
        {
        Result = Bindings.MemberP(PresentationContexts[i]);
        if (Result)
            {
            *PresentationContextSupported = i;
            break;
            }
        }
    return Result;
}


inline UINT
OSF_CCONNECTION::InqMaximumFragmentLength (
    )
/*++

Return Value:

    The maximum fragment length negotiated for this connection will be
    returned.

--*/
{
    return(MaxFrag);
}

#pragma optimize("", on)




inline void
OSF_CCONNECTION::SetLastTimeUsedToNow (
    )
/*++

Routine Description:

    We the the last time that this connection was used to now.

--*/
{
    LastTimeUsed = NtGetTickCount();
}

inline ULONG
OSF_CCONNECTION::InquireLastTimeUsed (
    )
/*++

Return Value:

    The last time this connection was used will be returned.

--*/
{
    return(LastTimeUsed);
}


inline RPC_STATUS
OSF_CCALL::InqSecurityContext (
    OUT void **SecurityContextHandle
    )
{
    *SecurityContextHandle = Connection->ClientSecurityContext.InqSecurityContext();
    return RPC_S_OK;
}

inline RPC_STATUS
OSF_CCALL::InqWireIdForSnego (
    OUT unsigned char *WireId
    )
{
    if ((Connection->ClientSecurityContext.AuthenticationLevel == RPC_C_AUTHN_LEVEL_NONE)
        || (Connection->ClientSecurityContext.AuthenticationService == RPC_C_AUTHN_NONE))
        return RPC_S_INVALID_BINDING;

    return Connection->ClientSecurityContext.GetWireIdForSnego(WireId);
}

inline RPC_STATUS 
OSF_CCALL::BindingHandleToAsyncHandle (
    OUT void **AsyncHandle
    )
{
    if (pAsync == 0)
        return RPC_S_INVALID_BINDING;

    *AsyncHandle = pAsync;
    return RPC_S_OK;
}

class OSF_BINDING : public MTSyntaxBinding
{
public:
    OSF_BINDING (
        IN RPC_SYNTAX_IDENTIFIER *InterfaceId,
        IN TRANSFER_SYNTAX_STUB_INFO *TransferSyntaxInfo,
        IN int CapabilitiesBitmap
        ) : MTSyntaxBinding(InterfaceId, TransferSyntaxInfo, CapabilitiesBitmap)
    {
    }

    inline void SetNextBinding(OSF_BINDING *Next)
    {
        MTSyntaxBinding::SetNextBinding(Next);
    }

    inline OSF_BINDING *GetNextBinding(void)
    {
        return (OSF_BINDING *)(MTSyntaxBinding::GetNextBinding());
    }    

    inline int CompareWithTransferSyntax (IN const p_syntax_id_t *TransferSyntax)
    {
        return CompareWithTransferSyntax ((RPC_SYNTAX_IDENTIFIER *)TransferSyntax);
    }

    inline int CompareWithTransferSyntax (IN const RPC_SYNTAX_IDENTIFIER *TransferSyntax)
    {
        return MTSyntaxBinding::CompareWithTransferSyntax ((RPC_SYNTAX_IDENTIFIER *)TransferSyntax);
    }

};


NEW_SDICT(OSF_BINDING);
NEW_SDICT(OSF_CCONNECTION);

enum MPX_TYPES
    {
    mpx_unknown,
    mpx_yes,
    mpx_no
    };

NEW_SDICT(RPC_TOKEN);


class OSF_CASSOCIATION : public REFERENCED_OBJECT
/*++

Class Description:

Fields:

    MaintainContext - Contains a flag indicating whether or not this
        association needs to keep at least one connection open with
        the server if at all possible.  A non-zero value indicates that
        at least one connection should be kept open.

    CallIdCounter - Contains an interlocked integer used to allocate
        unique call identifiers.

    BindHandleCount - Counts the number of OSF_BINDING_HANDLEs using
        this association.  This particular variable is operated
        with interlocks. However, adding a refcount if you don't have
        one (as in FindOrCreateAssociation - through the global data
        structure) requires holding AssocDictMutex.
--*/
{
friend class OSF_CCONNECTION;
friend class OSF_CCALL;
friend class OSF_BINDING_HANDLE;

private:
    DCE_BINDING * DceBinding;
    INTERLOCKED_INTEGER BindHandleCount;
    ULONG AssocGroupId;
    OSF_BINDING_DICT    Bindings;
    OSF_CCONNECTION_DICT ActiveConnections;

    TRANS_INFO *TransInfo ;
    unsigned char * SecondaryEndpoint;
    int Key;
    UINT OpenConnectionCount;
    UINT ConnectionsDoingBindCount;
    BOOL fPossibleServerReset;

    UINT MaintainContext;
    ULONG  CallIdCounter;

    MUTEX AssociationMutex;

    BOOL AssociationValid;

    // in some cases we will decide that the association is dead,
    // and we will mark it as such so that other calls can
    // quickly fail instead of banging against a dead server.
    // The error with which the association was shutdown is
    // stored here. Callers that implement quick failure detection
    // can read it off here. This is valid only if
    // AssociationValid == FALSE.
    RPC_STATUS AssociationShutdownError;

    BOOL DontLinger;

    BOOL ResolverHintInitialized;

    // protected by the AssociationMutex
    BOOL fIdleConnectionCleanupNeeded;

    int FailureCount;
    MPX_TYPES fMultiplex;
    unsigned long SavedDrep;
    RPC_TOKEN_DICT TokenDict;

    union
        {
        struct
            {
            // TRUE if this is an association without binding handle
            // references to it (i.e. it is lingered), FALSE
            // otherwise. Protected by the AssocDictMutex
            BOOL fAssociationLingered;

            // The timestamp for garbage collecting this item. Defined
            // only if fAssociationLingered == TRUE. Protected by the 
            // AssocDictMutex
            DWORD Timestamp;
            } Linger;

        // this arm of the union is used only during destruction - never use
        // it outside
        OSF_CASSOCIATION *NextAssociation;
    };

public:

    OSF_CASSOCIATION (
        IN DCE_BINDING * DceBinding,
        IN TRANS_INFO *TransInfo,
        IN OUT RPC_STATUS  * RpcStatus
        );

    ~OSF_CASSOCIATION (
        );

public:

#if 0
    void
    CleanupAuthenticatedConnections(
        IN CLIENT_AUTH_INFO *ClientAuthInfo
        );
#endif

    void
    UnBind ( // Decrement the BindingCount, and clean up the
             // association if it reaches zero.
        );

    RPC_STATUS 
    FindOrCreateOsfBinding (
        IN PRPC_CLIENT_INTERFACE RpcInterfaceInformation,
        IN RPC_MESSAGE *Message,
        OUT int *NumberOfBindings,
        IN OUT OSF_BINDING *BindingsForThisInterface[]
        );

    BOOL
    DoesBindingForInterfaceExist (
        IN PRPC_CLIENT_INTERFACE RpcInterfaceInformation
        );

    RPC_STATUS
    AllocateCCall (
        IN OSF_BINDING_HANDLE *BindingHandle,
        IN PRPC_MESSAGE Message,
        IN CLIENT_AUTH_INFO * ClientAuthInfo,
        OUT OSF_CCALL ** CCall,
        OUT BOOL *fBindingHandleReferenceRemoved
        );

private:

    RPC_STATUS
    ProcessBindAckOrNak (
        IN rpcconn_common *Buffer,
        IN UINT BufferLength,
        IN OSF_CCONNECTION *CConnection,
        IN OSF_CCALL *CCall,
        OUT ULONG *NewGroupId,
        OUT OSF_BINDING **BindingNegotiated,
        OUT FAILURE_COUNT_STATE *fFailureCountExceeded OPTIONAL
        );

    OSF_CCONNECTION *
    LookForExistingConnection (
        IN OSF_BINDING_HANDLE *BindingHandle,
        IN BOOL fExclusive,
        IN CLIENT_AUTH_INFO *ClientAuthInfo,
        IN int *PresentContext,
        IN int NumberOfPresentationContexts,
        OUT int *PresentationContextSupported,
        OUT OSF_CCALL_STATE *InitialCallState,
        IN BOOL fNonCausal
        );

    inline void
    ClearIdleConnectionCleanupFlag (
        void
        )
    {
        AssociationMutex.VerifyOwned();
        
        if (fIdleConnectionCleanupNeeded)
            {
            fIdleConnectionCleanupNeeded = FALSE;
            if (InterlockedDecrement(&PeriodicGarbageCollectItems) == 0)
                {
#if defined (RPC_GC_AUDIT)
                DbgPrintEx(77, DPFLTR_WARNING_LEVEL, "%d (0x%X) PeriodicGarbageCollectItems dropped to 0 (a)\n",
                    GetCurrentProcessId(), GetCurrentProcessId());
#endif
                }
            }
    }

public:

    int
    CompareWithDceBinding (
        IN DCE_BINDING * DceBinding,
        OUT BOOL *fOnlyEndpointDifferent
        );

    //
    // Note, whoever calls this routine must have already
    // requested the AssociationDictMutex.
    //
    void
    IncrementCount (
        void
        ) 
    {
        LogEvent(SU_CASSOC, EV_INC, this, (PVOID)2, BindHandleCount.GetInteger(), 1, 0);
        BindHandleCount.Increment();
    }

    void
    ShutdownRequested (
        IN RPC_STATUS AssociationShutdownError OPTIONAL,
        IN OSF_CCONNECTION *ExemptConnection OPTIONAL
        );

    inline OSF_BINDING *
    FindBinding (
        IN int PresentContext
        ) 
    {
        return(Bindings.Find(PresentContext));
    }

    virtual RPC_STATUS
    ToStringBinding (
        OUT RPC_CHAR  *  * StringBinding,
        IN RPC_UUID * ObjectUuid
        );

    OSF_CCONNECTION *
    FindIdleConnection (
        void
        );

    void
    MaintainingContext (
        );

    DCE_BINDING *
    DuplicateDceBinding (
        );

    BOOL
    IsValid (
        );

    BOOL
    ConnectionAborted (
        IN OSF_CCONNECTION *Connection
        );

    void
    NotifyConnectionOpen (
        );

    void
    NotifyConnectionClosed (
        );

    void NotifyConnectionBindInProgress (
        void
        );

    void NotifyConnectionBindCompleted (
        void
        );

    void * operator new (
        size_t allocBlock,
        unsigned int xtraBytes
        );

    int
    CompareResolverHint (
        void *Hint
        );

    void *
    InqResolverHint (
        );

    void
    SetResolverHint (
        void *Hint
        );

    void
    FreeResolverHint (
        void *Hint
        );

    inline BOOL
    IsResolverHintSynchronizationNeeded (
        void
        );

    inline void
    ResetAssociation (
       ) 
    {
        AssocGroupId = 0;
        if (ResolverHintInitialized)
            {
            ResolverHintInitialized = FALSE;
            FreeResolverHint(InqResolverHint());
            }
    }

    BOOL
    IsAssociationReset ( void )
    {
        return (AssocGroupId == 0);
    }

    RPC_STATUS
    FindOrCreateToken (
        IN HANDLE hToken,
        IN LUID *pLuid,
        OUT RPC_TOKEN **ppToken,
        OUT BOOL *pfTokenFound
        );

    void
    ReferenceToken(
        IN RPC_TOKEN *pToken
        );

    void
    DereferenceToken(
        IN RPC_TOKEN *pToken
        );

    void
    CleanupConnectionList(
        IN RPC_TOKEN *pToken
        );

    static void
    OsfDeleteLingeringAssociations (
        void
        );

    inline BOOL
    GetDontLingerState (
        void
        )
    {
        return DontLinger;
    }

    inline void
    SetDontLingerState (
        IN BOOL DontLinger
        )
    {
        ASSERT(DontLinger == TRUE);
        ASSERT(this->DontLinger == FALSE);
        this->DontLinger = DontLinger;
    }
};

inline int
OSF_CASSOCIATION::CompareResolverHint (
        void *Hint
        )
{
    RPC_CONNECTION_TRANSPORT *ClientInfo =
            (RPC_CONNECTION_TRANSPORT *) TransInfo->InqTransInfo();

    if (ClientInfo->CompareResolverHint)
        {
        return ClientInfo->CompareResolverHint(TransResolverHint(), Hint);
        }
    else
        {
        return RpcpMemoryCompare(TransResolverHint(), Hint, ClientInfo->ResolverHintSize);
        }
}

inline void *
OSF_CASSOCIATION::InqResolverHint (
        )
{
    return TransResolverHint();
}

inline void
OSF_CASSOCIATION::SetResolverHint (
        void *Hint
        )
{
    RPC_CONNECTION_TRANSPORT *ClientInfo =
            (RPC_CONNECTION_TRANSPORT *) TransInfo->InqTransInfo();

    if (ClientInfo->CopyResolverHint)
        {
        if (TransResolverHint() != Hint)
            {
            ClientInfo->CopyResolverHint(TransResolverHint(), 
                Hint, 
                TRUE    // SourceWillBeAbandoned
                );
            }
        }
    else
        {
        RpcpMemoryCopy(TransResolverHint(), Hint, ClientInfo->ResolverHintSize);
        }
}

inline void
OSF_CASSOCIATION::FreeResolverHint (
    void *Hint
    )
{
    RPC_CONNECTION_TRANSPORT *ClientInfo =
            (RPC_CONNECTION_TRANSPORT *) TransInfo->InqTransInfo();

    if (ClientInfo->FreeResolverHint)
        {
        ClientInfo->FreeResolverHint(Hint);
        }
}

BOOL
OSF_CASSOCIATION::IsResolverHintSynchronizationNeeded (
    void
    )
{
    RPC_CONNECTION_TRANSPORT *ClientInfo =
            (RPC_CONNECTION_TRANSPORT *) TransInfo->InqTransInfo();

    return (ClientInfo->FreeResolverHint != NULL);
}

inline void *
OSF_CASSOCIATION::operator new (
        size_t allocBlock,
        unsigned int xtraBytes
        )
{
    I_RPC_HANDLE pvTemp = (I_RPC_HANDLE) new char[allocBlock + xtraBytes];

    return(pvTemp);
}

inline BOOL
OSF_CASSOCIATION::IsValid (
    )
{
    return AssociationValid ;
}


inline void
OSF_CASSOCIATION::MaintainingContext (
    )
/*++

Routine Description:

    This routine is used to indicate that a binding handle using this
    association is maintaining context with the server.  This means
    that at least one connection for this association must always be
    open.

--*/
{
    MaintainContext = 1;
}


inline DCE_BINDING *
OSF_CASSOCIATION::DuplicateDceBinding (
    )
{
    return(DceBinding->DuplicateDceBinding());
}

inline ULONG
OSF_CCONNECTION::GetAssocGroupId (
    )
{
    return Association->AssocGroupId ;
}

inline void
OSF_CCONNECTION::WaitForSend (
    )
{
    while (ConnectionReady == 0)
        {
        //
        // We need a listening thread
        // so the send can complete
        //
        Association->TransInfo->CreateThread();
        Sleep(10);
        }

    ASSERT(ConnectionReady == 1);
    ConnectionReady = 0;
}

inline void
OSF_CCONNECTION::DeleteConnection (
    )
{
    if (fExclusive == 0)
        {
        TransAbortConnection();
        }

    Delete();
}

inline RPC_CHAR *OSF_CCONNECTION::InqEndpoint(void)
    {
    return Association->DceBinding->InqEndpoint();
    }

inline RPC_CHAR *OSF_CCONNECTION::InqNetworkAddress(void)
    {
    return Association->DceBinding->InqNetworkAddress();
    }

inline void 
OSF_BINDING_HANDLE::Unbind ()
{
    BOOL fMutexTaken;

    // try to take the two mutexes, but if fail on the second, release
    // the first as well and retry, because there is a potential
    // deadlock condition for which this is a workaround
    while (TRUE)
        {
        AssocDictMutex->Request();
        fMutexTaken = Association->AssociationMutex.TryRequest();
        if (fMutexTaken)
            break;
        else
            {
            AssocDictMutex->Clear();
            Sleep(10);
            }
        }

    if (pToken)
        {
        Association->DereferenceToken(pToken);
        pToken = 0;
        }

    // unbind will clear the association dict mutex
    // and the association mutex
    Association->UnBind();

    Association = 0;
}

RPC_STATUS
LoadableTransportClientInfo (
    IN RPC_CHAR * DllName,
    IN RPC_CHAR  * RpcProtocolSequence,
    OUT TRANS_INFO *  *ClientTransInfo
    );

TRANS_INFO  *
GetLoadedClientTransportInfoFromId (
    IN unsigned short TransportId
    );

RPC_STATUS SetAuthInformation (
    IN RPC_BINDING_HANDLE BindingHandle,
    IN CLIENT_AUTH_INFO *AuthInfo
    );

// --------------------------------------------------------------------

#endif // __OSFCLNT_HXX__