Fonction ADsGetObject (adshlp.h)
La fonction ADsGetObject se lie à un objet en fonction de son chemin et d’un identificateur d’interface spécifié.
Syntaxe
HRESULT ADsGetObject(
[in] LPCWSTR lpszPathName,
[in] REFIID riid,
[out] VOID **ppObject
);
Paramètres
[in] lpszPathName
Type : LPCWSTR
Chaîne Unicode terminée par une valeur Null qui spécifie le chemin utilisé pour la liaison à l’objet dans le service d’annuaire sous-jacent. Pour plus d’informations et des exemples de code pour les chaînes de liaison pour ce paramètre, consultez LDAP ADsPath et WinNT ADsPath.
[in] riid
Type : REFIID
Identificateur d’interface pour une interface spécifiée sur cet objet.
[out] ppObject
Type : VOID**
Pointeur vers un pointeur vers l’interface demandée.
Valeur retournée
Type : HRESULT
Cette méthode prend en charge les valeurs de retour HRESULT standard, ainsi que les éléments suivants.
Pour plus d’informations sur les autres valeurs de retour, consultez Codes d’erreur ADSI.
Remarques
Un client C/C++ appelle la fonction d’assistance ADsGetObject pour établir une liaison à un objet ADSI. Cela équivaut à un client Visual Basic appelant la fonction GetObject . Ils prennent tous les deux un ADsPath comme entrée et retournent un pointeur vers l’interface demandée. Par défaut, la liaison utilise ADS_SECURE_AUTHENTICATION option avec le contexte de sécurité du thread appelant. Toutefois, si l’authentification échoue, la liaison sécurisée est rétrogradée en liaison anonyme, par exemple une liaison simple sans informations d’identification utilisateur. Pour établir une liaison sécurisée à un objet ADSI, utilisez la fonction ADsOpenObject au lieu de la fonction ADsGetObject .
Pour obtenir un exemple de code montrant comment utiliser ADsOpenObject, consultez Liaison avec GetObject et ADsGetObject.
Il est possible de lier à un objet ADSI avec des informations d’identification utilisateur différentes de celle de l’utilisateur actuellement connecté. Pour effectuer cette opération, utilisez la fonction ADsOpenObject .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | adshlp.h |
| Bibliothèque | Activeds.lib |
| DLL | Activeds.dll |