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

Se connecte au catalogue COM+ sur un ordinateur distant spécifié.

Syntaxe

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

Paramètres

[in] bstrCatalogServerName

Nom de l'ordinateur distant. Pour vous connecter à l’ordinateur local, utilisez une chaîne vide.

[out, retval] ppCatalogCollection

Interface ICatalogCollection pour la collection racine sur l’ordinateur distant.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL et S_OK.

Remarques

La méthode Connect récupère également une collection racine liée à l’ordinateur distant. Une collection racine sert de point de départ pour localiser les collections de niveau supérieur et ne contient pas d’objets ou de propriétés.

Vous pouvez utiliser la méthode GetCollection pour obtenir une collection de niveau supérieur sur l’ordinateur local sans utiliser au préalable la méthode Connect .

Lorsque vous utilisez la méthode Connect , l’interface ICOMAdminCatalog que vous détenez fonctionne sur l’ordinateur auquel vous êtes connecté.

Configuration requise

Voir aussi

ICOMAdminCatalog