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

  • Artigo

O método IDirectorySearch::GetNextColumnName obtém o nome da próxima coluna no resultado da pesquisa que contém dados.

Sintaxe

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

Parâmetros

[in] hSearchHandle

Fornece um identificador para o contexto de pesquisa.

[out] ppszColumnName

Fornece o endereço de um ponteiro para uma cadeia de caracteres alocada pelo método que contém o nome da coluna solicitada. Se FOR NULL, nenhuma linha subsequente conterá dados.

Valor retornado

Esse método retorna os valores de retorno padrão, bem como os seguintes:

Para obter outros valores retornados, consulte Códigos de erro ADSI.

Comentários

Esse método aloca memória suficiente para o nome da coluna, mas o chamador deve chamar a função auxiliar FreeADsMem para liberar essa memória quando ela não for mais necessária.

Exemplos

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 com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho iads.h
DLL Activeds.dll; Adsldp.dll; Adsldpc.dll

Confira também

Códigos de erro ADSI

FreeADsMem

Idirectorysearch