Método IDirectoryObject::GetObjectInformation (iads.h)
El método IDirectoryObject::GetObjectInformation recupera un puntero a una estructura de ADS_OBJECT_INFO que contiene datos relacionados con la identidad y la ubicación de un objeto de servicio de directorio.
Sintaxis
HRESULT GetObjectInformation(
[out] PADS_OBJECT_INFO *ppObjInfo
);
Parámetros
[out] ppObjInfo
Proporciona la dirección de un puntero a una estructura de ADS_OBJECT_INFO que contiene datos relacionados con el objeto de servicio de directorio solicitado. Si ppObjInfo es NULL a cambio, GetObjectInformation no puede obtener los datos solicitados.
Valor devuelto
Este método devuelve los valores devueltos estándar, incluidos los S_OK cuando los datos se obtienen correctamente. Para obtener más información y otros valores devueltos, consulta Códigos de error ADSI.
Comentarios
El llamador debe llamar a la función auxiliar FreeADsMem para liberar la estructura de ADS_OBJECT_INFO creada por la función GetObjectInformation .
Los clientes de Automation deben llamar a IADs::GetInfo.
Ejemplos
En el siguiente ejemplo de código de C++ se muestra cómo recuperar los datos del objeto (ADS_OBJECT_INFO) mediante el método GetObjectInformation de un objeto (m_pDirObject) que implementa la interfaz 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 | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | iads.h |
| Archivo DLL | Activeds.dll |