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

El método IDirectorySearch::GetNextColumnName obtiene el nombre de la columna siguiente en el resultado de búsqueda que contiene datos.

Sintaxis

HRESULT GetNextColumnName(
  [in]  ADS_SEARCH_HANDLE hSearchHandle,
  [out] LPWSTR            *ppszColumnName
);

Parámetros

[in] hSearchHandle

Proporciona un identificador para el contexto de búsqueda.

[out] ppszColumnName

Proporciona la dirección de un puntero a una cadena asignada por el método que contiene el nombre de columna solicitado. Si es NULL, ninguna fila posterior contiene datos.

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

Este método asigna memoria suficiente para el nombre de columna, pero el autor de la llamada debe llamar a la función auxiliar FreeADsMem para liberar esta memoria cuando ya no sea necesario.

Ejemplos

LPWSTR pszColumn;
m_pSearch->GetFirstRow( hSearch );
printf("Column names are: ");
while( m_pSearch->GetNextColumnName( hSearch, &pszColumn ) != S_ADS_NOMORE_COLUMNS )
{
   printf("%S ", pszColumn );
   FreeADsMem( pszColumn );
}

Requisitos

Consulte también

Códigos de error adsi

FreeADsMem

IDirectorySearch