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

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	iads.h
DLL	Activeds.dll

Confira também

Códigos de erro ADSI

ADS_OBJECT_INFO

IADs::GetInfo

IDirectoryObject