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

  • Artigo

Conecta-se ao catálogo COM+ em um computador remoto especificado.

Sintaxe

HRESULT Connect(
  [in]          BSTR      bstrCatalogServerName,
  [out, retval] IDispatch **ppCatalogCollection
);

Parâmetros

[in] bstrCatalogServerName

O nome do computador remoto. Para se conectar ao computador local, use uma cadeia de caracteres vazia.

[out, retval] ppCatalogCollection

A interface ICatalogCollection para a coleção raiz no computador remoto.

Retornar valor

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

Comentários

O método Connect também recupera uma coleção raiz associada ao computador remoto. Uma coleção raiz serve como ponto de partida para localizar coleções de nível superior e não contém objetos ou propriedades.

Você pode usar o método GetCollection para obter uma coleção de nível superior no computador local sem primeiro usar o método Connect .

Quando você usa o método Connect , a interface ICOMAdminCatalog que você está mantendo funciona no computador ao qual você se conectou.

Requisitos

Requisito Valor
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