passwordModule.dll

Copyright 2001	Jaime A. Fuhr, fuhrj@penguinsoftwareworks.com
Released by The Penguin Software Works
July 5, 2001

NOTICE!
This DLL and any programs included with it are provided AS IS freeware.  There are no warranties with this product and no support is available.
Please test this module on a non-production machine before 




CONTENTS:
I.	Description
II.	How to Use
III.	Sample Program
IV.	Notes
V.	Registration
VII.	Freeware License Agreement


I.	DESCRIPTION

	The passwordModule.dll is a light weight COM object that you can use in any development language that allows access to COM objects.
	Examples of such are Visual Basic 5 and ASP.

	The program will generate a randomized password in either of the following formats:
		1)  Alpha
		2)  Alphanumeric
		3)  Numeric
		4)  Alpha, numeric, and various other characters

II.	HOW TO USE

	First, you will need to register passwordModule.dll.  Move the DLL to the desired location and then type
	the following command:  

		regsvr32 passwordModule.dll

	You may need to reboot your system after the DLL has been registered.

	To generate a password, first create a passwordGen object.  Next call the generatePassword() function and supply the
	desired parameters.  The function syntax for generatePassword is:

		[String] generatePassword(length as Integer, genType as String)

		Where:
			length	- type of integer.  Sets the number of characters that the generated password will contain
			genType	- type of string.  Indicates what type of characters are in the password.  Valid genTypes are:
				all-		Contains all characters
				alpha -		Contains only alpha characters, uppercase and lowercase
				alphanumeric	Both alpha and numeric characters
				numeric	-	Contains only numeric characters
		
		This function returns a type of string

	Example Code:

		Visual Basic 5.0
		* Be sure that the DLL is included in the project "Reference" section.  Click Project, References, and then check the
		  box next to passwordModule.

			dim passObj as new passwordGen
			dim getPassword

			'Returns a password 5 characters long, containing only alpha characters
			getPassword = passObj.generatePassword(5, "alpha")

			'Returns a password 8 characters long, containing alpha-numeric characters
			getPassword = passObj.generatePassword(8, "alphanumeric")

			set passObj = nothing

		
		ASP (Active Server Pages)

			<%
			dim passObj, getPassword

			set passObj = server.createObject("passwordModule.passwordGen")
		
			getPassword = passObj.generatePassword(8, "alpha")

			response.write( getPassword)

			set passObj = nothing
			%>


III.	SAMPLE PROGRAM

	A sample password generator program is included with the passwordModule.dll.  It was created in VB 5.0 and can
	be freely modified.

	You must register passwordModule.dll before running the executable.


IV.	NOTES

	No notes at this time

			
V.	REGISTRATION

	If you find this program useful, please consider registering it for $9.95.  Registration will include email notices of
	future updates to the program.

	To register, please visit http://penguinsoftwareworks.com/store/

	Thank you for supporting SHAREWARE!


VI.	FREEWARE LICENSE AGREEMENT

	This is a legal agreement between you (either an individual or an entity) and Penguin Software Works Co (PSW).
	By installing this software, you are agreeing to be bound by the terms of this agreement.

	This software is free and released AS IS!

	You may use the software on your system for as long as you like. 
	You may use and distribute this DLL in any applications, commercial or personal.  If used
	in a commercial application, please include credit to Penguin Software Works in the About 
	box of your program.

	You are specifically prohibited from charging, or requesting donations, for any such copies, however made; 
	without prior written permission from PSW.  

	The software is copyrighted and may not be modified under any circumstances.

	You may not decompile, disassemble or otherwise reverse engineer the software. Your use of the software is at your own risk. 
	The PSW or Jaime A. Fuhr shall not be held liable for consequential, special, indirect or other similar damages 
	or claims, including loss of profits or any other commercial damages.  PSW specifically disclaims all other warranties, expressed 
	or implied, including but not limited to implied warranties of merchantibility and fitness to a particular purpose.  
	PSW is not obligated in any fashion to provide technical assistance or other support with regard to your use of these products. 

	Your use of the software constitutes your acknowledgement and acceptance of these conditions.
