Compartilhar via


Método ICOMAdminCatalog2::AliasComponent (comadmin.h)

Cria um alias para um componente COM+ existente.

Sintaxe

HRESULT AliasComponent(
  [in] BSTR bstrSrcApplicationIDOrName,
  [in] BSTR bstrCLSIDOrProgID,
  [in] BSTR bstrDestApplicationIDOrName,
  [in] BSTR bstrNewProgId,
  [in] BSTR bstrNewClsid
);

Parâmetros

[in] bstrSrcApplicationIDOrName

A ID do aplicativo ou o nome do aplicativo de origem que contém o componente.

[in] bstrCLSIDOrProgID

A ID da classe ou a ID do programa do componente para o qual um alias é criado.

[in] bstrDestApplicationIDOrName

A ID do aplicativo ou o nome do aplicativo de destino que contém o alias. Se esse argumento for NULL ou uma cadeia de caracteres vazia, o alias será criado no aplicativo de origem.

[in] bstrNewProgId

A ID do programa do alias.

[in] bstrNewClsid

A ID de classe do alias. Se esse argumento for NULL ou uma cadeia de caracteres vazia, uma nova ID de classe exclusiva será atribuída.

Retornar valor

Esse método pode retornar os valores retornados 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.
COMADMIN_E_AMBIGUOUS_APPLICATION_NAME
Pelo menos um dos aplicativos nomeados existe em várias partições. Para evitar esse erro, use IDs de aplicativo em vez de nomes.

Requisitos

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

Confira também

ICOMAdminCatalog2