Metodo IDirectoryObject::GetObjectInformation (iads.h)

Articolo
02/28/2024

Il metodo IDirectoryObject::GetObjectInformation recupera un puntatore a una struttura ADS_OBJECT_INFO contenente i dati relativi all'identità e alla posizione di un oggetto servizio directory.

Sintassi

HRESULT GetObjectInformation(
  [out] PADS_OBJECT_INFO *ppObjInfo
);

Parametri

[out] ppObjInfo

Fornisce l'indirizzo di un puntatore a una struttura ADS_OBJECT_INFO contenente dati relativi all'oggetto servizio directory richiesto. Se ppObjInfo è NULL in caso di restituzione, GetObjectInformation non può ottenere i dati richiesti.

Valore restituito

Questo metodo restituisce i valori restituiti standard, inclusi S_OK quando i dati vengono ottenuti correttamente. Per altre informazioni e altri valori restituiti, vedere Codici di errore ADSI.

Commenti

Il chiamante deve chiamare la funzione helper FreeADsMem per rilasciare la struttura ADS_OBJECT_INFO creata dalla funzione GetObjectInformation .

I client di automazione devono chiamare IADs::GetInfo.

Esempio

Nell'esempio di codice C++ seguente viene illustrato come recuperare i dati dell'oggetto (ADS_OBJECT_INFO) usando il metodo GetObjectInformation di un oggetto (m_pDirObject) che implementa l'interfaccia 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 );

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	iads.h
DLL	Activeds.dll