SAMPLE: Create and Delete Virtual Directories in IIS 4.0

ID: Q188954

The information in this article applies to:

SUMMARY

CrtVDirD.exe is a self extracting executable that contains a Visual C++ sample that demonstrates how to add and delete Virtual Directories and Applications in Internet Information Server (IIS) 4.0 using the IIS Admin Base Object and the IWamAdmin Object. The sample was built with Visual C++ 5.0.

MORE INFORMATION

The following file is available for download from the Microsoft Software Library: 

 ~ CrtVDirD.exe (size: 36864 bytes)
Release Date: 04-30-1998

For more information about downloading files from the Microsoft Software Library, please see the following article in the Microsoft Knowledge Base: 

   ARTICLE-ID: Q119591
   TITLE : How to Obtain Microsoft Support Files from Online Services
CrtVDir: uses the IIS Admin Base Object to add or remove Virtual Directories to a Web Server. It uses the IWamAdmin object to create or remove Applications.

NOTE: It is necessary for a virtual directory to exist before creating an application.

Usage:

To create a Virtual Directory (CD): 

   CrtVDir.exe CD <path> <name> [<permissions>] [<site>]
To remove a Virtual Directory (RD): 

   CrtVDir.exe RD <name> [<site>]
To create an Application (CA): 

   CrtVDir.exe CA <metabasepath> <INPROC|OOP>
To remove an Application (RA): 

   CrtVDir.exe RA <metabasepath>
Params:

Path - Physical path to which the Virtual Directory refers.

Name - Name for virtual directory.

Metabasepath - Metabasepath is the full metabase path to the relevant key. 

               Note that if the path you enter does not begin with a "/"
               character, ISAPIReg prepends "/LM/" to the path.
Permissions - see later reference in article.

Site - Defaults to "1" if not supplied.

INPROC|OOP - Application runs in-process of out-of-process.

Permissions - The following values are for the common permission flags. 

              These may be added together to form a combination of
              permissions for the virtual root:

                 1 = Read Access
                 2 = Write Access
                 4 = Execute Access (including Script)
                 512 = Script Access
Samples:

To obtain help on the command line parameters: 

   C:> CrtVDir.exe
To create NewVDir Virtual Directory pointing to D:\InetPub\wwwroot\NewVDir: 

   C:> CrtVDir.exe CD D:\InetPub\wwwroot\NewVDir NewVDir
To remove the same directory: 

   C:> CrtVDir.exe RD NewVDir
To create an application: 

   C:> CrtVDir.exe CA w3svc/1/root/NewVDir INPROC
To remove an application: 

   C:> CrtVDir.exe RA w3svc/1/root/NewVDir
Metabase Issues:

The metabase is a secure object, and requires sufficient permissions to open and use. Any application that uses this code to access the metabase must run in a context with appropriate permissions.

The header file for IWamAdmin was not included in the Internet Information Server (IIS) 4.0 Software Development Kit (SDK). You can get the file from the following Web site: 

   ftp://ftp.microsoft.com/bussys/IIS/iis-public/iis40/SDK/iwamreg.h

REFERENCES

Microsoft Internet Information Server 4.0 Documentation 

Keywords          : iisapi 
Version           : WINNT:4.0
Platform          : winnt

Last Reviewed: August 12, 1998