IWamAdmin::AppCreate

  • Article

The IWamAdmin::AppCreate method creates a Web application definition and marks it as running in-process or out-of-process. If an application already exists at the specified path, this method reconfigures the application from in-process to out-of-process execution, or vice versa.

HRESULT STDMETHODCALLTYPE AppCreate(
      LPCWSTR szMDPath,
      BOOL fInProc
);

Parameters

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

  • fInProc
    [in] Specifies whether the application being created is to run in-process (TRUE) or out-of-process (FALSE). If the application already exists and is running in-process, specifying this flag as FALSE will cause the application definition to be deleted and a new application created to run out-of-process. If the application already exists and is running out-of-process, specifying this flag as TRUE will cause the application definition to be deleted and a new application created to run in-process. If the application exists and the setting of fInProc matches the application's existing status, then this method will cause no change to the application definition.

Return Values

The method will return S_OK if the method succeeded, or other error codes converted to an HRESULT if the method failed.

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.