ICOMAdminCatalog::InstallApplication method (comadmin.h)

Installs a COM+ application or application proxy from the specified file.

Syntax

HRESULT InstallApplication(
  [in]           BSTR bstrApplicationFile,
  [in, optional] BSTR bstrDestinationDirectory,
  [in, optional] long lOptions,
  [in, optional] BSTR bstrUserId,
  [in, optional] BSTR bstrPassword,
  [in, optional] BSTR bstrRSN
);

Parameters

[in] bstrApplicationFile

The name of the file containing the application to be installed.

[in, optional] bstrDestinationDirectory

Where to install the components. If this parameter is blank, the default directory is used.

[in, optional] lOptions

The option flags. This parameter can be one of the following values.

Value	Meaning
COMAdminInstallNoUsers 0	Do not install users saved in application file (default).
COMAdminInstallUsers 1	Install users saved in an application file.
COMAdminInstallForceOverwriteOfFiles 2	Overwrite files.

[in, optional] bstrUserId

The user ID under which to run the application.

[in, optional] bstrPassword

The password under which to run the application.

[in, optional] bstrRSN

A remote server name to use for an application proxy.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following values.

Return code	Description
S_OK	The method completed successfully.
ERROR_INSTALL_FAILURE	A fatal error occurred during installation.
COMADMIN_E_OBJECT_DOES_NOT_EXIST	The application does not exist.
COMADMIN_E_OBJECTERRORS	An error occurred accessing one or more objects.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	comadmin.h

See also

ICOMAdminCatalog