Método IDirectorySearch::GetColumn (iads.h)

Artículo
08/24/2023

El método IDirectorySearch::GetColumn obtiene datos de una columna con nombre del resultado de búsqueda.

Sintaxis

HRESULT GetColumn(
  [in]  ADS_SEARCH_HANDLE  hSearchResult,
  [in]  LPWSTR             szColumnName,
  [out] PADS_SEARCH_COLUMN pSearchColumn
);

Parámetros

[in] hSearchResult

Proporciona un identificador para el contexto de búsqueda.

[in] szColumnName

Proporciona el nombre de la columna para la que se solicitan los datos.

[out] pSearchColumn

Proporciona la dirección de una estructura de ADS_SEARCH_COLUMN asignada por el método que contiene la columna de la fila actual del resultado de búsqueda.

Valor devuelto

Este método devuelve los valores devueltos estándar, así como los siguientes.

Para obtener otros valores devueltos, consulta Códigos de error ADSI.

Comentarios

El método asigna la memoria de la estructura ADS_SEARCH_COLUMN para contener los datos de la columna. Pero el autor de la llamada debe liberar la memoria llamando a IDirectorySearch::FreeColumn.

El método IDirectorySearch::GetColumn intenta leer la definición de esquema del atributo solicitado para que pueda devolver los valores de atributo en el formato adecuado en las estructuras ADSVALUE , contenidas en la estructura ADS_SEARCH_COLUMN . Sin embargo, GetColumn puede realizarse correctamente incluso cuando la definición de esquema no está disponible, en cuyo caso el miembro dwADsType de la estructura ADS_SEARCH_COLUMN devuelve ADSTYPE_PROV_SPECIFIC y el valor se devuelve en una estructura ADS_PROV_SPECIFIC . Al procesar los resultados de una llamada a GetColumn , debe comprobar dwADsType para asegurarse de que los datos se devolvieron en el formato esperado.

Ejemplos

ADS_SEARCH_COLUMN col;
/*.. Omit the set preference and execute*/
while( m_pSearch->GetNextRow( hSearch) != S_ADS_NOMORE_ROWS )
{
   // Get the Name and display it in the list.
   hr = m_pSearch->GetColumn( hSearch, pszAttr[0], &col );
   if ( SUCCEEDED(hr) )
   {
          switch (col.dwADsType)
          {
             case ADSTYPE_CASE_IGNORE_STRING:
                printf("%S\n", col.pADsValues->CaseIgnoreString);
             break;
 
             case ADSTYPE_PROV_SPECIFIC:
                printf("%S\n", col.pADsValues->ProviderSpecific.lpValue);
             break;
 
             default:
                printf("Unexpected ADsType: %d\n", col.dwADsType);
             break;
          }

          {
             m_pSearch->FreeColumn( &col );
          }
   }

}

m_pSearch->CloseSearchHandle( hSearch );

Requisitos


Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	iads.h
Archivo DLL	Activeds.dll; Adsldp.dll; Adsldpc.dll