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
| 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 |