Método ICOMAdminCatalog::InstallApplication (comadmin.h)

Artigo
08/22/2023

Instala um aplicativo COM+ ou um proxy de aplicativo do arquivo especificado.

Sintaxe

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
);

Parâmetros

[in] bstrApplicationFile

O nome do arquivo que contém o aplicativo a ser instalado.

[in, optional] bstrDestinationDirectory

Onde instalar os componentes. Se esse parâmetro estiver em branco, o diretório padrão será usado.

[in, optional] lOptions

Os sinalizadores de opção. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
COMAdminInstallNoUsers 0	Não instale usuários salvos no arquivo de aplicativo (padrão).
COMAdminInstallUsers 1	Instale os usuários salvos em um arquivo de aplicativo.
COMAdminInstallForceOverwriteOfFiles 2	Substituir arquivos.

[in, optional] bstrUserId

A ID de usuário na qual executar o aplicativo.

[in, optional] bstrPassword

A senha sob a qual executar o aplicativo.

[in, optional] bstrRSN

Um nome de servidor remoto a ser usado para um proxy de aplicativo.

Valor retornado

Esse método pode retornar os valores de retorno padrão E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED e E_FAIL, bem como os valores a seguir.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
ERROR_INSTALL_FAILURE	Um erro fatal ocorreu durante a instalação.
COMADMIN_E_OBJECT_DOES_NOT_EXIST	O aplicativo não existe.
COMADMIN_E_OBJECTERRORS	Ocorreu um erro ao acessar um ou mais objetos.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	comadmin.h

Confira também

ICOMAdminCatalog

Compartilhar via