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

Статья
08/24/2023

Метод 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

Поделиться через