Метод IDirectoryObject::GetObjectInformation (iads.h)

Метод IDirectoryObject::GetObjectInformation извлекает указатель на структуру ADS_OBJECT_INFO , содержащую данные об идентификаторе и расположении объекта службы каталогов.

Синтаксис

HRESULT GetObjectInformation(
  [out] PADS_OBJECT_INFO *ppObjInfo
);

Параметры

[out] ppObjInfo

Предоставляет адрес указателя на структуру ADS_OBJECT_INFO , содержащую данные о запрошенном объекте службы каталогов. Если параметр ppObjInfo имеет значение NULL при возврате, GetObjectInformation не может получить запрошенные данные.

Возвращаемое значение

Этот метод возвращает стандартные возвращаемые значения, включая S_OK при успешном получении данных. Дополнительные сведения и другие возвращаемые значения см. в разделе Коды ошибок ADSI.

Комментарии

Вызывающий объект должен вызвать вспомогательную функцию FreeADsMem , чтобы освободить структуру ADS_OBJECT_INFO , созданную функцией GetObjectInformation .

Клиенты автоматизации должны вызывать IADs::GetInfo.

Примеры

В следующем примере кода C++ показано, как получить данные объекта (ADS_OBJECT_INFO) с помощью метода GetObjectInformation объекта (m_pDirObject), реализующего интерфейс 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 );

Требования

См. также раздел

Коды ошибок ADSI

ADS_OBJECT_INFO

IADs::GetInfo

IDirectoryObject