IDirectoryObject::GetObjectInformation-Methode (iads.h)
Die IDirectoryObject::GetObjectInformation-Methode ruft einen Zeiger auf eine ADS_OBJECT_INFO-Struktur ab, die Daten zur Identität und zum Speicherort eines Verzeichnisdienstobjekts enthält.
Syntax
HRESULT GetObjectInformation(
[out] PADS_OBJECT_INFO *ppObjInfo
);
Parameter
[out] ppObjInfo
Stellt die Adresse eines Zeigers auf eine ADS_OBJECT_INFO-Struktur bereit, die Daten zum angeforderten Verzeichnisdienstobjekt enthält. Wenn ppObjInfo bei der Rückgabe NULL ist, kann GetObjectInformation die angeforderten Daten nicht abrufen.
Rückgabewert
Diese Methode gibt die Standardrückgabewerte zurück, einschließlich S_OK , wenn die Daten erfolgreich abgerufen werden. Weitere Informationen und andere Rückgabewerte finden Sie unter ADSI-Fehlercodes.
Hinweise
Der Aufrufer sollte die FreeADsMem-Hilfsfunktion aufrufen, um die von der GetObjectInformation-Funktion erstellte ADS_OBJECT_INFO Struktur freizugeben.
Automatisierungsclients müssen IADs::GetInfo aufrufen.
Beispiele
Das folgende C++-Codebeispiel zeigt, wie Die Objektdaten (ADS_OBJECT_INFO) mithilfe der GetObjectInformation-Methode eines Objekts (m_pDirObject) abgerufen werden, das die IDirectoryObject-Schnittstelle implementiert.
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 );
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | iads.h |
| DLL | Activeds.dll |