ASPFusion is a suite of ASP components bundled with a security box and an administrator interface that makes all components secured for shared hosting and allows the administrator to turn component access on/off for individual web sites. ASPFusion brings a new concept in defining user rights and permissions. The conventional method of defining user rights that Windows offers simply 'fail' in shared hosting environments because every user coming through the Internet is anonymous. For servers which host hundreds of web sites on a single box, there's got to be a way to discern that the call is coming through which web site and that web site's permissions be applied. ASPFusion maintains a security box for one or a group of websites and analyze each call to any of its methods to find out the physical path of the 'calling ASP template' and matches it with the permissions defined in the Security Box and either grants or denies access. A security box contains all the relevant information that needs to be kept for that website(s). Important items include

1. The physical path on the hard disc above which they are not allowed to modify anything, this is usually the FTP root given to them.
2. The List of existing DSNs. These and any more DSNs made are assigned to the Securit Box that applies.
3. The base path in registry for this Security Box. A separate base path in registry is maintained for each Security Box and users are then not allowed to write to registry above that base path

As soon as a component is loaded onto a Windows server, everyone having his site hosted on that server gets full access to all its methods. This is a security risk where it might not be safe to give control to all web sites for some specific component specially the ones which interact with content on the server. Examples include components for server side file and directory management, ODBC DSN management and registry management etc.

Security Box is actually a physical path on your hard disc. ASPFusion Administrator keeps components permissions according to Security Boxes or physical paths on your hard disc. All files and directories under a Security Box are considered part of that Secuity Box. Therefore all Security Boxes on a server should be parallel to each other as one Security Box cannot fall under another Security Box.
One Security Box is usually created for the FTP or WWW root of each new website. The access for individual components can then be turned on/off for that websites through its own Security Box.
Each ASPFusion component checks the path of the calling ASP script first to see if it falls under ANY Security Box. If yes it finds out the Security Box and checks if the specific method being called is allowed to this Security Box. It will only do the job if it is allowed otherwise it will send an access denied message.

First of all free components do not provide the extra security required for shared hosting environment. e.g. advFile and advDirectory are comprehensive server side File and Directory management components but do not allow any operation above the Security Box root. This closes the security hazard where one website owner can maliciously delete files or folders on someone else's web site.
Similarly the advRegistry component lets users store and delete data in server side registry but again restricts users to a specific path in registry which is different for each Security Box.

The maximum size of file upload using advFile is not dependent of memory. It is only dependent on the amount of disk space available on the server.

We claim an exceptionally low memory usage by advFile during file upload as it is specially made for shared hosting servers where multiple users are uploading files simultaneously.
Unlike many other popular file upload components which take precious server side memory equal to the size of the file being uploaded, advFile consumes a maximum of 200KB per file and typically takes only 64KB per file regardless of the size of the file being uploaded. This means that a server with 256MB of RAM can easily take a few thousand simultaneous file uploads of any size.

SendMail blocks the ASP page and send the Email there and then. As sending multiple Emails can be a very time taking process, the page might not return for a very long time.
To avoid this users are encouraged to use SendQMail in which AdvSMTP just writes a text file on server side and returns control to the calling ASP page immediately.
Any errors which might popup then during actual Email transmission, can then be viewed in the mails logs.

advSMTP service can send upto 40 mails at a time in 40 different threads. Remember advSMTP supports multiple SMTP servers so you can give multiple IP addresses and advSMTP will intelligently manage load between them.

The ASPFusion Administrator assign a Registry root path to each Security Box which is usually given to one website only. Users of that web site are then restricted to that server side Registry path and below. This restricts shared hosting users from manipulating content on sensitive server side registry parts and still gives them flexibility to store information in server side registry.

By default advSMTP can send upto 40 mails at a time, but you can change it easily to work according to your requirements. There can be two cases.

• If you have installed ASPFusion administration pages then, just login to it and you will find an edit box entry named as Mail Threads in section AdvSMTP General Settings. Please change this value to number of mails that you want to send through advSMTP service at a time, and then click Apply button.


• If you have registered advSMTP manually then you have to change this entry from registry settings. Please follow these steps to change this entry directly in system registry.
  
  
  • Open system registry, e.g. C:\>regedit.
  
  
  • Open registry key HKEY_LOCAL_MACHINE\SOFTWARE\Advanced Communications\ASPFusion.
  
  
  • You will find a DWORD value named as MailThreads. Please change this value to number of mails that you want to send through advSMTP service at a time.

You can change it easily. There can be two cases.

• If you have installed ASPFusion administration pages then, just login to it and you will find an edit box entry named as Spool Folder in section AdvSMTP General Settings. Please change this value to path where you want to place advSMTP spool files, and then click Apply button.


• If you have registered advSMTP manually then you have to change this entry from registry settings. Please follow these steps to change this entry directly in system registry.
  
  
  • Open system registry, e.g. C:\>regedit.
  
  
  • Open registry key HKEY_LOCAL_MACHINE\SOFTWARE\Advanced Communications\ASPFusion.
  
  
  • You will find a STRING value named as MailPath. Please change this value to path where you want to place advSMTP spool files.

You can change it easily. There can be two cases.

• If you have installed ASPFusion administration pages then, just login to it and you will find an edit box entry named as Recyclebin Folder in section AdvSMTP General Settings. Please change this value to path where you want to place advSMTP undeliverable files, and then click Apply button.


• If you have registered advSMTP manually then you have to change this entry from registry settings. Please follow these steps to change this entry directly in system registry.
  
  
  • Open system registry, e.g. C:\>regedit.
  
  
  • Open registry key HKEY_LOCAL_MACHINE\SOFTWARE\Advanced Communications\ASPFusion.
  
  
  • You will find a STRING value named as MailRecycleBin. Please change this value to path where you want to place advSMTP undeliverable files.

No, there can be only one spool folder where advSMTP component will place spool files and advSMTP service will deliver them. If advSMTP service is unable to send some mail then it will place it in undeliverable folder.
But you can also specify undeliverable folder through a property named as RecyclebinPath. This property is used, if you want to place your undeliverable mails in your separate folder, otherwise undeliverable mails will be placed in default undeliverable folder.

You can change it easily. There can be two cases.

• If you have installed ASPFusion administration pages then, just login to it and you will find an edit box entry named as Log Folder in section AdvSMTP General Settings. Please change this value to path where you want to place advSMTP host log files, and then click Apply button.


• If you have registered advSMTP manually then you have to change this entry from registry settings. Please follow these steps to change this entry directly in system registry.
  
  
  • Open system registry, e.g. C:\>regedit.
  
  
  • Open registry key HKEY_LOCAL_MACHINE\SOFTWARE\Advanced Communications\ASPFusion.
  
  
  • You will find a STRING value named as MailLog. Please change this value to path where you want to place advSMTP host log files.

Spool timer is the time interval in seconds for which advSMTP service will process on spool files.

By default advSMTP process on spool files after 5 seconds, but you can change it easily to work according to your requirements. There can be two cases.

• If you have installed ASPFusion administration pages then, just login to it and you will find an edit box entry named as Spool Timer in section AdvSMTP General Settings. Please change this value to time in seconds after which advSMTP service will process on spool files, and then click Apply button.


• If you have registered advSMTP manually then you have to change this entry from registry settings. Please follow these steps to change this entry directly in system registry.
  
  
  • Open system registry, e.g. C:\>regedit.
  
  
  • Open registry key HKEY_LOCAL_MACHINE\SOFTWARE\Advanced Communications\ASPFusion.
  
  
  • You will find a DWORD value named as MailTimer. Please change this value to time in seconds after which advSMTP service will process on spool files.

Mail Retries is the number of retries that advSMTP service will try to send a mail.

By default advSMTP mail retries value is 1, but you can change it easily to work according to your requirements. There can be two cases.

• If you have installed ASPFusion administration pages then, just login to it and you will find an edit box entry named as Mail Retries in section AdvSMTP General Settings. Please change this value to number of retries you need, and then click Apply button.


• If you have registered advSMTP manually then you have to change this entry from registry settings. Please follow these steps to change this entry directly in system registry.
  
  
  • Open system registry, e.g. C:\>regedit.
  
  
  • Open registry key HKEY_LOCAL_MACHINE\SOFTWARE\Advanced Communications\ASPFusion.
  
  
  • You will find a DWORD value named as MailRetries. Please change this value to number of retries you need.

Well this Log Folder path is used to create host log files. If host logging is turned ON then advSMTP service will perform logging for all sent mails.

advSMTP service will create only one host log file per day and will create new host log file every day.

By default advSMTP host logging is set ON and will do ERROR logging, but you can change it easily to work according to your requirements. There can be two cases.

• If you have installed ASPFusion administration pages then, just login to it and you will find a combo box entry named as Host Logging in section AdvSMTP Host Logging Settings. Please change this to value as you like to do NO, ERROR or COMPLETE logging, and then click Apply button.


• If you have registered advSMTP manually then you have to change this entry from registry settings. Please follow these steps to change this entry directly in system registry.
  
  
  • Open system registry, e.g. C:\>regedit.
  
  
  • Open registry key HKEY_LOCAL_MACHINE\SOFTWARE\Advanced Communications\ASPFusion.
  
  
  • You will find a DWORD value named as HostLogging. Please change its value to 0, 1 or 2 as you like to do NO, ERROR or COMPLETE logging respectively.

advSMTP has capability to deliver mail without using any external SMTP server.

By default advSMTP is set to deliver mail without using any external SMTP server, but you can change it easily to work according to your requirements. There can be two cases.

• If you have installed ASPFusion administration pages then, just login to it and you will find a radio button entry named as Direct Deliver in section AdvSMTP Message Delivery Settings. Please select it if you don't want advSMTP to use any external SMTP server for mail delivery, and then click Apply button.


• If you have registered advSMTP manually then you have to change this entry from registry settings. Please follow these steps to change this entry directly in system registry.
  
  
  • Open system registry, e.g. C:\>regedit.
  
  
  • Open registry key HKEY_LOCAL_MACHINE\SOFTWARE\Advanced Communications\ASPFusion.
  
  
  • You will find a DWORD value named as DNSLookup. Please set its value 1 if you don't want advSMTP to use any external SMTP server for mail delivery.

There is no limitations in AdvFile component for file size, memory usage or browser compatibility.

There is a method UploadAs in advSMTP component to save a file with different name. Here is a sample code:
<%
set Result = Obj.UploadAs("c:\myfolder")
for each Member in Result
  if Member.FileField = "file1" then
    Member.NameConflict = "overwrite"
    Member.SaveAs("newfilename.extension")
    if Member.IsError = 1 then
      Response.Write Member.ErrorReason
    else
      Response.Write Member.ClientFileName
      Response.Write Member.ClientFileExtension
      Response.Write Member.ServerFileName
      Response.Write Member.ServerFileExtension
      Response.Write Member.ContentType
      Response.Write Member.FileField
      Response.Write Member.CreationTime
      Response.Write Member.LastModifiedTime
      Response.Write Member.FilePath
      Response.Write Member.FileSize
    end if
  end if
next
set Result = nothing
%>

AdvFile component has a property named as DownloadForceFully. If this property is set as TRUE then component will download the file forcefully and if this property is set as FALSE then component will not download the file forcefully, and browser will decide whether to display or download the file.

Here is the sample code to get HTML through a proxy server.
<%
dim HTTP
set HTTP = Server.CreateObject("AdvHTTP.HTTP")
HTTP.Port = Request.Form("Port") 'your server http port
HTTP.ProxyServer = Request.Form("ProxyServer") 'your proxy server ip or name
HTTP.ProxyPort = Request.Form("ProxyPort") 'your proxy server port
HTTP.URL = Request.Form("URL") 'URL to access e.g. http://www.microsoft.com
set Result = HTTP.Get() 'call GET method
if (HTTP.IsError = 1) then 'check if some error occurred
  'some error occurred
  Response.Write HTTP.ErrorReason 'print error on page
else
  'no error occurred
  Response.Write "MimeType: " & Result.MimeType 'contains mime type
  Response.Write "Header: " & Result.Header 'contains http headers
  Response.Write "FileContent: " & Result.FileContent 'contains page data, this is your required variable
end if
set Result = Nothing
set HTTP = Nothing
%>

Here is the sample code to post a file.
<%
dim HTTP
set HTTP = Server.CreateObject("AdvHTTP.HTTP")
'post form fields
HTTP.FormField "FormFieldName", "FormFieldValue"
'you can specify more form fields to be post using this ".FormField" method, you can use this method to send your ID number 'post files
HTTP.File "FilePostName", "FilePostCompletePath"
' e.g. HTTP.File "file1", "C:\Windows\calc.exe"
'you can specify more files to be post using this ".File" method, you can use this method to post your xml file
HTTP.URL = "URL"
'perform post method on this URL
set Result = HTTP.Post()
'call to post method
if (HTTP.IsError = 1) then
  Response.Write "Error: " & HTTP.ErrorReason
else
  Response.Write Result.FileContent
end if
set Result = Nothing
set HTTP = Nothing
%>

To fetch for example 10 messages at a time, there is a property named MessageNumberOrUID. If it is set as 1:10 then Fetch will return messages with sequence number starts from 1 and ends at 10. Also 1,10 (comma separated list) can be given which means messages with sequence number 1 and 10 only.

There is a property named as Attributes in AdvLDAP component. It is a semicolon ";" separated list of attributes against which the values should be retrieved from the LDAP server. Use this property to get fully qualified names.

There is no limitation for attribute size in LDAP component.

Same LDAP component can be used to search some other data by setting all its properties again, as Set Result = obj.Query() Will return the array of objects, but this will initialize the array object internally to perform next query. You first have to set all of its properties again and then perform the next search.

Query method of AdvLDAP component returns array of objects and you have to loop it over using FOR EACH to access all of its objects and their data members.

After purchasing the component, you must receive a serial key for that component. Please enter this key from ASPFusion Administration or through the desktop application shipped with every product download, or you just simply enter it directly in registry at location HKEY_LOCAL_MACHINE\SOFTWARE\Advanced Communications\ASPFusion\AdvLDAP with string value name as SerialNo.

There is a property Filter in AdvLDAP component. It can be used to authenticate a user. Its usage is:
  obj.Filter = "(&(cn=user_name)(userpassword=user_password))"

After authenticating a specific user using Filter property there is a property named as Attributes, using that property you can get information about the user. Its usage is:
  obj.Attributes = "First Name;Last Name;Phone Number;Email Address"

Attribute can be modified by using the LDAP’s AttributeModify method.
  LDAP.AttributeModify "mailAlias", "test@test.com", -1, False

To delete an Attribute, specify the required attribute in LDAP.DN method and than call LDAP.Delete method.

The sample code to add a user record in the LDAP database.
<%
set LDAP = Server.CreateObject("AdvLDAP.LDAP")
LDAP.ServerName = "MyLdapServer"
LDAP.UserName = "uid=admin, o=aspfusion.net"
LDAP.Password = "admin"
LDAP.Attributes = "objectclass=top, person, organizationalPerson, inetOrgPerson;cn=Haider Ali;sn=Ali;mail=haider@aspfusion.net;telephonenumber=+923335115521;ou=aspfusion.net"
LDAP.DN "uid","haider"
LDAP.DN "o","aspfusion.net"
LDAP.Add()
if LDAP.iserror = 1 then
  Response.Write LDAP.errorreason
else
  Response.Write "SUCCESS"
end if
%>

There is a property named as Filter in AdvLDAP component. It can be used as
  ldapObj.Filter = (cust_attribute=certain_word)

There is a method is AdvLDAP component named as AttributeModify which is used to set the value of attributes of the entry, which is required to be modified in the LDAP server. Use this method to change password for the required user in LDAP server.

AdvLDAP component does not support SSL-Directory server, it works for non SSL-Sirectory server.

To get the specific results according to a particular search criteria, you have to use the FILTER property of AdvLDAP component.
  LDAPObj.Filter = "(&(firstname=a)(lastname=b))"
This will return all records in which first name is 'a' and last name is 'b'.
Filter syntax is
  (LOGICAL_OPERATOR (SEARCH_CRITERIA_1)(SEARCH_CRITERIA_2))
where
  LOGICAL_OPERATOR can be AND ( & ), OR ( | ) operator or any other operator or combination of operators.
In case of combination, please follow this syntax,
  (LOGICAL_OPERATOR(LOGICAL_OPERATOR (SEARCH_CRITERIA_1)(SEARCH_CRITERIA_2))(LOGICAL_OPERATOR (SEARCH_CRITERIA_1)(SEARCH_CRITERIA_2)))

We can access different fields like uid, sn etc using QUERY method of AdvLDAP component. When we need to retrieve password then we need to provide valid LDAP server admin user and password using UserName and Password property of AdvLDAP component. e.g.
  LDAP.UserName = "LDAP Server Admin User Name To Perform Query To Retrieve Password"
  LDAP.Password = "LDAP Server Admin User Password To Perform Query To Retrieve Password"

To check username and password at a time, use FILTER like this,
  LDAPobj.Filter = "(&(cn=John)(userpassword=john2002))"
where John is user name and john2002 is password to be compare at a time.

DN method of AdvLDAP component is used to specify the distinguished name of the entry on LDAP server. For going in depth in the directory tree, call this method multiple times with specifying the Attribute from top to the bottom.
Its syntax is like this
  Obj.DN Attribute, Value

AdvPOP3 component does not support for SSL.

AdvPOP3 does not support UUEncode encoding scheme, it only support Base64 and Quoted-Printable encoding schemes.

AdvPOP3 component supports unicode characters or languages that use double-byte characters like Chinese, Japnese etc. AdvPOP3 component supports both Base64 and Quoted-Printable encoding which is usually used for unicode characters or double-byte characters.

AdvPOP3 component only returns content-type of the message but it does not return charset value in its current version.

The component AdvPOP3 is tested for all multi-threaded issues and it can handle multiple requests at the same time.

There is a method of AdvPOP3 component named as "Delete". We can use this method to delete a mail from the server using its sequence number. Whenever you call "GetAll" or "GetHeaderOnly" to fetch a mail from server then please DON'T call its "Delete" method, to leave message on server, and then store its returned "UID" somewhere in database. Whenever you next call any of methods "GetAll" or "GetHeaderOnly" then assign these stored UIDs to property "DownloadedUIDs" so that only new messages are fetched.

In POP3 protocol we can only fetch message using their message sequence numbers. Whenever we fetch a message from POP3 server using GetAll method then UID of message is returned in collection. We can store this UID in some database and whenever we fetch message again using GetAll then you can pass these stored UIDs in this DownloadedUIDs property. This is how DownloadedUIDs will work.

Email send and recieved in text/plain-mode contains no CRLF. So all text is in one line. To show the orignial format the replace-function can be used as
Replace(mail.body,vbcrlf,"<br>")

The best way is to retrieve mail messages using GetAll method, this will return a value named MessageNo, then create a list using these returned messages numbers and assign this list to MessageNumber property and call Delete method. This will delete all retrieved mail messages.

When GetHeaderOnly action is performed to get headers for mail message then a field named "ContentType" is returned, which is actually content type of mail message. If its value contains "multipart/mixed" then it means there is some attachment with this mail message.

To delete an entire registry tree there is a method Delete in AdvRegistry that will delete the entire registry tree. Here is the sample code that will delete the registry tree named cBranch.
<%
dim Registry
set Registry = Server.CreateObject("AdvRegistry.Registry")
Registry.Entry = "" 'if you want to delete the entire tree, set its value as empty string
Registry.Delete(cBranch)
if (Registry.IsError = 1) then
  Response.Write "Error:" & Registry.ErrorReason & "
"
else
  Response.Write "Successfully delete" & "
"
end if
set Directory = Nothing
%>

HKEY_CURRENT_USER registry key is related to current logged in user. Now give 'administrator' account as authentication user to the virtual directory from where you are calling your ASP script. Now it can create a key and assign it some value to HKEY_CURRENT_USER.

Yes there is a way in which you can assign the template data to .BODY and .HTMLBODY property of AdvSMTP component.

To start loggin please open registry location
HKEY_LOCAL_MACHINE\SOFTWARE\Advanced Communications\ASPFusion, here you will find a DWORD value named as HostLogging, please set its value as 2. Now it will start logging.

Please open registry location "HKEY_LOCAL_MACHINE\SOFTWARE\Advanced Communications\AspFusion"
create a "String" value with name "MailPath", and edit it with physical path where you want to place spooled mails for sending through AdvSMTP service. Also create this path on the disk.
Create another "String" value with name "MailRecycleBin", and edit it with physical path where you want to place those mails. Also create this path on your disk.

There are two ways in which AdvSMTP sends mail.
1.  Blocking
2.  NonBlocking
In first case AdvSMTP sends mail and wait untill it get some result back from SMTP server.
In second case AdvSMTP saves mail message on physical path. Then AdvSMTP Service is responsible for sending that saved mail message. For each mail message AdvSMTP Service creates a separate thread. So that it can send multiple mails at a time in separate threads.
In case of AdvSMTP Service, if hundreds of mail messages from different users are sent then we need to avoid extra traffic for SMTP server. For this purpose we have fix the maximum number of threads in AdvSMTP Service, which is 40. All mail messages more then 40 have to wait at the path where they are saved, till any thread of existing 40 threads is finished, then next mail message from the path is picked up and processed. Also in case of 40 mails at a time, we need to avoid extra traffic for single SMTP server. For this purpose we use multiple SMTP servers. If you specify 1 SMTP server then all 40 threads will try to send their mail messages through this single SMTP server but if you specify 5 SMTP servers then AdvSMTP Service will manage it in this way that each SMTP server will send 8 mails at a time. In this way load between multiple SMTP servers is managed.

There is a property in AdvZIP component named as UsePath. This property is used to inform AdvZIP component whether to zip given files using their complete path or using their names only. This property is ignored in case of adding folders to zip. Valid values are
TRUE (default) in case of TRUE component will zip files using their complete path.
FALSE if it is set as FALSE then component will zip files using their names only.

There are some issues of using AdvZIP component with UNC path and it is not recommended yet to use AdvZIP component for UNC path and files.

Its not possible in AdvZIP component to change the compression ratio.

AdvZIP component specially designed to be used on WinNT technology as due to its Security Box implementation. It can't be used on Win9x.

AdvZIP component does not support to rename files as they are added to the zip file.

AdvZIP component zips the files only in secondary storage on physical file locations.

No, AdvZIP component does not support password protected ZIP files.

AdvZIP component only supports windows based zip files. It can't process on .gz files.

All ASPFusion components including AdvZIP performs communication with server to check availability of any new version. If there is a new version available then administrator will be informed on ASPFusion administration pages, so that he can download latest version. Thats why it uses Wininet API.

No, there is no such support in AdvZIP component.

There is no difference between trial version and purchased version, the only difference is that trial version will work for 30 days only and purchased version will never expire.

There is a property in AdvFile component named as Form, this property can be used to retrieve value for any posted form element.

The installer of ASPFusion tries to create virtual directory on IIS for ASPFusion and it fails and throws an error when you try to install it on Apache, but you can set it manually. Please copy all ASPFusion CF_ZIP templates in ColdFusion custom tags directory. You can find CF_ZIP templates in CustomTags folder at location where you have installed ASPFusion. Please copy these templates in ColdFusion custom tags directory.

ADvFile component manages simple text files but it does not support to write PDF archive or any other special file format