IISApp Interface

The IISApp interface contains methods that can create, delete, enable, disable, unload, restart, or query the state of Web applications IIS. This interface can be used from a C++ or Visual Basic application that uses ADSI. The required header files, Iiisext.h and IISext_i.c, are installed with Visual Studio and the IIS Software Developer Kit.

For a C++ code example that uses ADSI to configure the metabase, see Using ADSI to Configure IIS in a C++ Application.

For an interface that manages application pools on IIS 6.0, see IISApp3 and IISApplicationPool Interface.

Methods in Vtable Order

In addition to the methods inherited from IADs, the IISApp interface exposes the following methods.

Method	Description
AppCreate	Creates a new Web application, or reconfigures an existing application.
AppDelete	Deletes an application definition.
AppDeleteRecursive	Marks a Web application as deleted so it can be moved or copied and then recovered.
AppDisable	Disables a Web application that is running. All of the application's resources are released and the application's process is terminated.
AppDisableRecursive	Disables a Web application that is running, and all of its child applications. All of the application's resources are released and the application's process is terminated.
AppEnable	Enables a Web application that was previously disabled with AppDisable.
AppEnableRecursive	Enables a Web application and all of its child applications that were previously disabled with AppDisableRecursive.
AppGetStatus	Retrieves the status of a Web application. This method is obsolete because it will not work on late-bound clients. Instead, use IISApp2::AppGetStatus2.
AppUnload	Unloads an application that is running.
AppUnloadRecursive	Unloads an application that is running and all of its child applications.
AspAppRestart	Restarts ASP applications. Users can use this method to restart ASP applications without accessing the Global.asa file or stopping and starting the Web service itself. Essentially, a user can restart the application on demand.

Requirements

Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

Header: Declared in iiisext.h; include iisext_i.c.

See Also

Concepts

IIS ADSI Provider Interfaces

Using ADSI to Configure IIS in a C++ Application

IIS Constants and Header Files

IWamAdmin Interface

IISApp2 Interface

IISApp3 Interface