Metodo IDirectoryObject::GetObjectInformation (iads.h)
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 |