connectivity/com.nokia.tcf/native/TCFNative/TCFServer/BaseProtocol.h
author fturovic <frank.turovich@nokia.com>
Thu, 14 May 2009 16:28:33 -0500
changeset 152 9e83cc047260
parent 60 9d2210c8eed2
child 458 70467d598794
permissions -rw-r--r--
bug 8066 - revised image and option description for dynamic variants
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
60
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
     1
/*
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
     2
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
     3
* All rights reserved.
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
     4
* This component and the accompanying materials are made available
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
     5
* under the terms of the License "Eclipse Public License v1.0"
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
     6
* which accompanies this distribution, and is available
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
     8
*
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
     9
* Initial Contributors:
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    11
*
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    12
* Contributors:
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    13
*
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    14
* Description: 
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    15
*
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    16
*/
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    17
// BaseProtocol.h: interface for the CBaseProtocol class.
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    18
//
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    19
//////////////////////////////////////////////////////////////////////
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    20
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    21
#if !defined(AFX_BASEPROTOCOL_H__EABB80B6_353C_45AE_8976_AE0C0D93AC84__INCLUDED_)
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    22
#define AFX_BASEPROTOCOL_H__EABB80B6_353C_45AE_8976_AE0C0D93AC84__INCLUDED_
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    23
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    24
#if _MSC_VER > 1000
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    25
#pragma once
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    26
#endif // _MSC_VER > 1000
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    27
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    28
class CBaseProtocol  
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    29
{
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    30
public:
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    31
	CBaseProtocol();
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    32
	virtual ~CBaseProtocol();
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    33
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    34
	// used to decode a message into header/message parts
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    35
	virtual BOOL DecodeMessage(BYTE* fullMessage, DWORD& fullLength, BYTE& msgId, BYTE*& rawMessage, DWORD& rawLength)=0;
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    36
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    37
	// used to encode a raw message (prefixes any protocol headers)
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    38
	virtual DWORD EncodeMessage(BYTE* rawMessage, DWORD rawLength, BYTE protocolVersion, BYTE msgId, BYTE* fullMessage, DWORD maxFullLength)=0;
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    39
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    40
	// used to query how many bytes the header is so the caller can allocate enough memory
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    41
	virtual DWORD GetHeaderLength()=0;
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    42
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    43
};
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    44
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    45
typedef const char* (*PROTOCOLREGISTER)(void);
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    46
typedef CBaseProtocol* (*PROTOCOLCREATE)(void);
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    47
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    48
#define PROTOCOLREGISTER_FNNAME	"RegisterProtocol"
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    49
#define PROTOCOLCREATE_FNNAME	"CreateProtocol"
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    50
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    51
#define PROTOCOLDLL_BASENAME	"TCFProt"
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    52
9d2210c8eed2 Commit changes for 2.1.0
chpeckha
parents:
diff changeset
    53
#endif // !defined(AFX_BASEPROTOCOL_H__EABB80B6_353C_45AE_8976_AE0C0D93AC84__INCLUDED_)