Partager via


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

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête comadmin.h

Voir aussi

ICOMAdminCatalog