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 |