awarenetclass.h

c++系统开发实例精粹内附的80例源代码 环境:windows2000,c++6.0

#ifndef AWARENETCLASS_INCLUDE
#define AWARENETCLASS_INCLUDE

#include "AwareNet.h"

/*
--------------------------AwareNet Library--------------------------

Version 1.19
Copyright(C) 1999, 2000 Tenebril Incorporated

  Extensive documentation is provided online at the
  Tenebril Incorporated web site.  It is accessible from,

  http://www.tenebril.com/developers/main.html

  Please refer to this documentation to learn how to use
  AwareNet.

---------------------------------------------------------------------
*/

class CPersonalInfo
{
	friend class CAwareNet;

public:
	CPersonalInfo();
	~CPersonalInfo();

	LPCTSTR GetName();
	LPCTSTR GetEMail();
	LPCTSTR GetPassword();

	BOOL    SetName(LPCTSTR czName);
	BOOL    SetEMail(LPCTSTR czEmail);
	BOOL    SetPassword(LPCTSTR czPassword);

	const CPersonalInfo &operator=(const CPersonalInfo &rInfo);
	const CPersonalInfo &operator=(const TPersonalInfo tInfo);

private:
	TPersonalInfo *m_pData;
};

class CAwareNet
{
public:
	CAwareNet();
	virtual ~CAwareNet();

	// Initialization / deallocation
	BOOL    Initialize(HWND hwndParent, int iService);
	BOOL    Deallocate(int iService);

	HWND    SetParentWindow(HWND hwndParent);
	
	// Profile functions
	BOOL    GetMyProfile(CPersonalInfo &rPInfo);
	BOOL    SetMyProfile(CPersonalInfo cPInfo);
	int     GetMyID();

	// Identity functions
	BOOL    ChangeIdentity();                   // Displays the GUI
	BOOL    AddIdentity();
	BOOL    DeleteIdentity(int iID);
	BOOL    SetIdentity(int iIdentityNum, LPCTSTR cszPassword);
	int     GetActiveIdentity();
	int     GetHighestIdentity();
	BOOL    GetIdentity(int iIdentityNum, LPTSTR czName, UINT nNameLen);
	BOOL    IsIdentityTaken(LPCTSTR czEMail);

	// Access friend / acquaintance lists
	int     GetFriend(int iNum);
	int     GetAcquaintance(int iNum);
	
	// Add / remove friends
	BOOL    Add(LPCTSTR czProgramName, LPCTSTR czProgramURL, int nTOS); // GUI
	BOOL    AddID(int iID);
	BOOL    Delete(int iID);

	// Anonymous acquaintances
	BOOL    GetAnonAquaintances(int nService, BOOL bRefresh, CStringArray &csaIPs);
	BOOL    AddAnonAcquaintances(int nNum, int nService);

	// Get information about a person
	BOOL    GetProfile(int iID, CPersonalInfo &rPInfo);
	BOOL    GetIP(CString &rczIP, int nID);
	BOOL    IsOnline(int iID, int iService, BOOL bForceLookup = FALSE);

	// Lookup information
	int     LookupID(LPCTSTR czEMail);
	BOOL    LookupProfile(int iID, CPersonalInfo &rPInfo);

	// Send an invitation
	BOOL    SendInvitation(LPCTSTR czRecipient, LPCTSTR czProgramName,
		                   LPCTSTR czProgramURL, int nTOS);

	// Auxiliary system functions
	BOOL    FlushData();
	BOOL    UpdateTOS(int iService, BOOL bUp);
	int     NumActiveTOS();
};

#endif