IDirectorySearch::GetNextColumnName-Methode (iads.h)

Die IDirectorySearch::GetNextColumnName-Methode ruft den Namen der nächsten Spalte im Suchergebnis ab, das Daten enthält.

Syntax

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

Parameter

[in] hSearchHandle

Stellt einen Handle für den Suchkontext bereit.

[out] ppszColumnName

Stellt die Adresse eines Zeigers auf eine methodenbezogene Zeichenfolge bereit, die den angeforderten Spaltennamen enthält. Wenn NULL keine nachfolgenden Zeilen Daten enthalten.

Rückgabewert

Diese Methode gibt die Standardrückgabewerte sowie folgendes zurück:

Weitere Rückgabewerte finden Sie unter ADSI-Fehlercodes.

Hinweise

Diese Methode weist genügend Arbeitsspeicher für den Spaltennamen zu, aber der Aufrufer muss die FreeADsMem-Hilfsfunktion aufrufen, um diesen Speicher freizugeben, wenn er nicht mehr benötigt wird.

Beispiele

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

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile iads.h
DLL Activeds.dll; Adsldp.dll; Adsldpc.dll

Weitere Informationen

ADSI-Fehlercodes

FreeADsMem

Idirectorysearch