IWamAdmin::AppDelete

  • Article

The IWamAdmin::AppDelete method deletes a Web application definition from this metabase key, and optionally all of its subkeys. If the application is running, it will be shut down. If the application is in-process with IIS, all out-of-process resources associated with the application will be released if the resources are not referenced by another in-process application.

Note

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

Deletions performed using IWamAdmin::AppDelete cannot be undone.

HRESULT STDMETHODCALLTYPE AppDelete(
      LPCWSTR szMDPath,
      BOOL fRecursive
);

Parameters

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

  • fRecursive
    [in] Specifies whether application definitions are also to be deleted from all subkeys (TRUE), or just from 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. 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.