Método IDirectoryObject::GetObjectInformation (iads.h)

O método IDirectoryObject::GetObjectInformation recupera um ponteiro para uma estrutura ADS_OBJECT_INFO que contém dados sobre a identidade e o local de um objeto de serviço de diretório.

Sintaxe

HRESULT GetObjectInformation(
  [out] PADS_OBJECT_INFO *ppObjInfo
);

Parâmetros

[out] ppObjInfo

Fornece o endereço de um ponteiro para uma estrutura ADS_OBJECT_INFO que contém dados sobre o objeto de serviço de diretório solicitado. Se ppObjInfo for NULL no retorno, GetObjectInformation não poderá obter os dados solicitados.

Retornar valor

Esse método retorna os valores de retorno padrão, incluindo S_OK quando os dados são obtidos com êxito. Para obter mais informações e outros valores retornados, consulte Códigos de erro ADSI.

Comentários

O chamador deve chamar a função auxiliar FreeADsMem para liberar a estrutura ADS_OBJECT_INFO criada pela função GetObjectInformation .

Os clientes de automação devem chamar IADs::GetInfo.

Exemplos

O exemplo de código C++ a seguir mostra como recuperar os dados do objeto (ADS_OBJECT_INFO) usando o método GetObjectInformation de um objeto (m_pDirObject) que implementa a interface 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 );

Requisitos

Confira também

Códigos de erro ADSI

ADS_OBJECT_INFO

IADs::GetInfo

IDirectoryObject