Fonction ADsGetObject (adshlp.h)

  • Article

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

Voir aussi

Codes d’erreur ADSI

Fonctions ADSI

ADsOpenObject

Liaison avec GetObject et ADsGetObject