IDirectoryObject::GetObjectInformation 메서드(iads.h)

아티클
02/28/2024

IDirectoryObject::GetObjectInformation 메서드는 디렉터리 서비스 개체의 ID 및 위치와 관련된 데이터를 포함하는 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 구조를 해제해야 합니다.

자동화 클라이언트는 IAD::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 );

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	iads.h
DLL	Activeds.dll