ICOMAdminCatalog::InstallApplication method (comadmin.h)

  • Article

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