IWamAdmin::AppUnload

  • Article

The IWamAdmin::AppUnload method unloads a Web application that is running out-of-process. All of the application's resources are released, and the application's process is terminated. If the application is running in-process, the application resource is released if it is not being referenced by any other in-process applications.

Note

Server component DLLs are not released from in-process applications, even if they aren't currently referenced by other applications.

HRESULT STDMETHODCALLTYPE AppUnLoad(
      LPCWSTR szMDPath,
      BOOL fRecursive
);

Parameters

  • szMDPath
    [string][unique][in] Specifies the metabase path to the starting point of the application.

  • fRecursive
    [in] Specifies whether applications are also to be unloaded from all subordinate keys (TRUE), or just the application at this key (FALSE).

Return Values

The method will return S_OK if the method succeeded, even if no application was defined at the specified path, or the application is not running. If the method fails, other error codes converted to an HRESULT will be returned.

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 iwamreg.h.