IDirectoryObject::GetObjectInformation method (iads.h)

Artikel
02/28/2024

Metode IDirectoryObject::GetObjectInformation mengambil pointer ke struktur ADS_OBJECT_INFO yang berisi data mengenai identitas dan lokasi objek layanan direktori.

Sintaks

HRESULT GetObjectInformation(
  [out] PADS_OBJECT_INFO *ppObjInfo
);

Parameter

[out] ppObjInfo

Menyediakan alamat penunjuk ke struktur ADS_OBJECT_INFO yang berisi data mengenai objek layanan direktori yang diminta. Jika ppObjInfoadalah NULL saat dikembalikan, GetObjectInformation tidak dapat memperoleh data yang diminta.

Nilai kembali

Metode ini mengembalikan nilai pengembalian standar, termasuk S_OK ketika data berhasil diperoleh. Untuk informasi selengkapnya dan nilai pengembalian lainnya, lihat Kode Kesalahan ADSI.

Keterangan

Pemanggil harus memanggil fungsi pembantu FreeADsMem untuk merilis struktur ADS_OBJECT_INFO yang dibuat oleh fungsi GetObjectInformation .

Klien Automation harus memanggil IAD::GetInfo.

Contoh

Contoh kode C++ berikut menunjukkan cara mengambil data objek (ADS_OBJECT_INFO) menggunakan metode GetObjectInformation objek (m_pDirObject) yang mengimplementasikan antarmuka 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 );

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	iads.h
DLL	Activeds.dll