POP3Srv OCX
(c)2005 Half-Eaten Software
http://half-eaten.scieron.com

Introduction
============

POP3Srv OCX is an ActiveX control that allows you to
incorporate a simple, streamlined, and fast POP3 e-mail
server into your own software. It supports an unlimited
number of user accounts.

Any standard POP3 e-mail client such as Microsoft Outlook
Express or Mozilla Thunderbird can be used to log into
the server. It can be used without an SMTP server and will
drop e-mail messages into any user's account with a simple
command.

If used in conjunction with an SMTP server, you can use
this control to write a fully functional professional grade
internet or intranet e-mail server.

Note: You must also have the standard mswinsck.ocx that comes
with Visual Basic and Visual C. This is never a problem,
but it is worth noting.



Registering
===========

If you have not registered, you can only use up to three user
accounts with the control. Also, you will see a nag screen whenever
you use the InitServer method. Other than that, it will still
be fully functional! We don't believe in time-trials for ActiveX
controls, since it doesn't give the developer a real chance to
work with the OCX.



How to use
==========

POP3Srv OCX is very easy to use. There are only a few commands
you have to understand to use it. Here is a list of the methods
available to you, and descriptions of how to use them.

METHODS:

POP3Srv.Register Name, RegCode
	-Once you have registered the software and received your
	 registration code, you can enter the name you used to
	 register along with your registration code to unlock
	 the software. If you have not registered, there will
	 be a nag screen when you initialize the server. Also,
	 you will not be able to have more than three user accounts!
	 Register the software at http://half-eaten.scieron.com
	 NOTE: THE "Name" ARGUMENT IS CASE-SENSITIVE!! So be sure
	 You note the cases of each character you used to register with.

	-"Name" is a case-sensitive string containing the exact
	 name you used to register the software with.
	
	-"RegCode" is a string containing the registration code
	 you were given when you registered, generated from the
	 name you gave us when registering. All this info will
	 be in the e-mail we send you after you send us payment.

POP3Srv.InitServer
	-Use this command to initialize the server. It's that
	 easy. Once it's initialized, a POP3 client can immedately
	 connect and receive a user's e-mail messages.

POP3Srv.SetMailPath
	-This method tells the server what directory you want to
	 use to store user mailboxes in. If you do not specify
	 a path, the mailboxes will be stored in the same directory
	 you are running the software out of.

POP3Srv.GetUserCount
	-This method returns a numerical value indicating how many
	 user accounts exist in the mail path.

POP3Srv.GetUserID (UserNumber)
	-This method returns a string containing the name of the
	 user number you specify. The UserNumber you enter must
	 be within the range of existing user accounts, which
	 can be determined using the GetUserCount method.

POP3Srv.ComposeMail fromUser, toUser, Subject, DateTime, Body
	-This method drops a mail message into the user account
	 specified in the "toUser" argument.
	
	-"fromUser" is a string containing the name and/or e-mail
	 address of the person that originally composed the message.

	-"toUser" is a string containing only the local username
	 that should have the mail message dropped into their inbox.
	 There should not be an actual e-mail address in the argument.
	 For example if the user's name is "mike" in the mail path,
	 this argument should simply be "mike" instead of "mike@domain.com"
	
	-"Subject" is a string containing the message's subject line. (Optional)

	-"DateTime" is a string containing the date and time that
	 the message originated at. (Optional)

	-"Body" is a string containing the FULL mail message body.
	 I.E. The contents of the actual mail.

POP3Srv.MakeNewUser UN, PW
	-This method creates a new user account in the mail path.

	-"UN" is a string containing the desired user name.

	-"PW" is a string containing the user's password.

POP3Srv.DeleteUser UserName
	-This method deletes a user's account from the mail path.

	-"UserName" is a string containing the user's account name
	 that is to be deleted from the mail path.


And that's it! Once you have mastered these methods, you will be using the server.




Configuring a POP3 client such as Microsoft Outlook Express to use the server
=============================================================================

You can configure your e-mail client to use this POP3 server just as you would
any other mail server. Just tell it to connect to the server machine's IP address
or hostname as the POP3 server. Note: It operates on standard POP3 port 110.

When logging in, simply use the user account name and password you entered when
you created the user account with the .MakeNewUser method!

It's that simple! Enjoy the program.




(c)2005 Half-Eaten Software
http://half-eaten.scieron.com