Метод IDirectorySearch::GetNextColumnName (iads.h)

  • Статья

Метод IDirectorySearch::GetNextColumnName получает имя следующего столбца в результатах поиска, содержащего данные.

Синтаксис

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

Параметры

[in] hSearchHandle

Предоставляет дескриптор для контекста поиска.

[out] ppszColumnName

Предоставляет адрес указателя на строку, выделенную методом, содержащую запрошенное имя столбца. Если значение РАВНО NULL, последующие строки не содержат данные.

Возвращаемое значение

Этот метод возвращает стандартные возвращаемые значения, а также следующие:

Другие возвращаемые значения см. в разделе Коды ошибок ADSI.

Комментарии

Этот метод выделяет достаточно памяти для имени столбца, но вызывающий объект должен вызвать вспомогаточную функцию FreeADsMem , чтобы освободить эту память, когда она больше не нужна.

Примеры

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 );
}

Требования

   
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header iads.h
DLL Activeds.dll; Adsldp.dll; Adsldpc.dll

См. также раздел

Коды ошибок ADSI

FreeADsMem

IDirectorySearch