Méthode IDirectoryObject ::GetObjectInformation (iads.h)
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 |