IDirectoryObject：：GetObjectInformation 方法 (iads.h)

项目
03/13/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 );