IDirectoryObject：：GetObjectInformation 方法 (iads.h)

發行項
03/05/2024

IDirectoryObject：：GetObjectInformation 方法會擷取ADS_OBJECT_INFO結構的指標，其中包含目錄服務物件身分識別和位置的相關數據。

語法

HRESULT GetObjectInformation(
  [out] PADS_OBJECT_INFO *ppObjInfo
);

參數

[out] ppObjInfo

提供 ADS_OBJECT_INFO結構的指標位址，其中包含所要求目錄服務對象的相關數據。如果傳回 ppObjInfo 為 NULL，GetObjectInformation 就無法取得要求的數據。

傳回值

這個方法會傳回標準傳回值，包括成功取得數據時 S_OK 。如需詳細資訊和其他傳回值，請參閱 ADSI 錯誤碼。

備註

呼叫端應該呼叫FreeADsMem協助程式函式，以釋放 GetObjectInformation 函式所建立的ADS_OBJECT_INFO結構。

自動化客戶端必須呼叫 IADs：：GetInfo。

範例

下列 C++ 程式代碼範例示範如何使用實作 IDirectoryObject 介面之 (m_pDirObject) 物件的 GetObjectInformation 方法，擷取對象數據 (ADS_OBJECT_INFO) 。

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 );