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

Artículo
02/28/2024

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