MACROMEDIA COLDFUSION 4.5-ADMINISTRING COLDFUSION..., Manual

Page: 81 / 350

Chapter 3: Configuring ColdFusion Server 59
you want to use ColdFusion with CGI or if you want to use absolute references to
ColdFusion pages with the CFINCLUDE tag.
For information about using ColdFusion with CGI instead of one of the standard Web
server APIs (NSAPI, ISAPI, Apache API, or WSAPI), see Chapter 7, “Using CGI with
ColdFusion,” on page 269.
The Web server APIs supported by ColdFusion (NSAPI, ISAPI, Apache API, and WSAPI)
perform document type mapping, which makes directory mapping in ColdFusion
unnecessary. When a browser loads a file with the
.cfm extension, the Web server
recognizes that file type as a ColdFusion application page.
Using the Extensions Pages
Use the ColdFusion Administrator Extensions pages to register Java applets and CFX
tags, custom tags built with C++.
Managing CFX tags
The CFX Tags page in the ColdFusion Administrator is used to Register and manage
ColdFusion custom tags built with C++.
ColdFusion allows you to build extensions or custom tags in two ways:
•
Using C++ to code DLLs (Windows) or shared objects (Solaris) that provide a
custom tag you can use in your application pages.
•
Using CFML to create custom tags you invoke in your application pages.
To use a CFX tag you must first register it with ColdFusion. This process simply tells
ColdFusion where to find the required DLL when it attempts to process the CFX tag in
an application page.
Note
A wide variety of custom tags of both types is available from the
ColdFusion Tag Gallery.
CFX tag samples
Source code and compiled versions of two sample CFX tags are installed with
ColdFusion (you can register and use them in your application pages). You must first
compile this code before registering the DLLs or shared objects in the ColdFusion
Administrator. These examples can be found in
opt/coldfusion/cfx/examples
(Solaris) and
cfusion\cfx\examples
(Windows).
The two CFX tag examples installed with ColdFusion are as follows:
•
directorylist
— Returns a directory listing.
•
ntuser_db
— (Windows NT only) Allows you to modify Windows NT user
permissions.