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

Weitere Informationen

ADSI-Fehlercodes

ADS_OBJECT_INFO

IADs::GetInfo

IDirectoryObject