Méthode IDirectoryObject ::GetObjectInformation (iads.h)

Article
02/28/2024

La méthode IDirectoryObject ::GetObjectInformation récupère un pointeur vers une structure de ADS_OBJECT_INFO qui contient des données concernant l’identité et l’emplacement d’un objet de service d’annuaire.

Syntaxe

HRESULT GetObjectInformation(
  [out] PADS_OBJECT_INFO *ppObjInfo
);

Paramètres

[out] ppObjInfo

Fournit l’adresse d’un pointeur vers une structure de ADS_OBJECT_INFO qui contient des données concernant l’objet de service d’annuaire demandé. Si ppObjInfo a la valeur NULL au retour, GetObjectInformation ne peut pas obtenir les données demandées.

Valeur retournée

Cette méthode retourne les valeurs de retour standard, y compris S_OK lorsque les données sont obtenues avec succès. Pour plus d’informations et d’autres valeurs de retour, consultez Codes d’erreur ADSI.

Remarques

L’appelant doit appeler la fonction d’assistance FreeADsMem pour libérer la structure ADS_OBJECT_INFO créée par la fonction GetObjectInformation .

Les clients Automation doivent appeler IADs ::GetInfo.

Exemples

L’exemple de code C++ suivant montre comment récupérer les données d’objet (ADS_OBJECT_INFO) à l’aide de la méthode GetObjectInformation d’un objet (m_pDirObject) qui implémente l’interface IDirectoryObject .

ADS_OBJECT_INFO *pInfo;
HRESULT hr;
 
hr = m_pDirObject->GetObjectInformation(&pInfo);
if (!SUCCEEDED(hr) )
{
   return;
}
 
//////////////////////////
// Show the attributes 
/////////////////////////
 
printf("RDN: %S\n", pInfo->pszRDN);
printf("ObjectDN: %S\n", pInfo->pszObjectDN);
printf("Parent DN: %S\n", pInfo->pszParentDN);
printf("Class Name: %S\n", pInfo->pszClassName);
printf("Schema DN: %S\n", pInfo->pszSchemaDN);
 
///////////////////////////////////////////////////////////
// Remember to clean up the memory using FreeADsMem.
//////////////////////////////////////////////////////////
FreeADsMem( pInfo );

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	iads.h
DLL	Activeds.dll