IDirectorySearch::GetNextColumnName-Methode (iads.h)

  • Artikel

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

Syntax

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

Parameter

[in] hSearchHandle

Stellt ein Handle für den Suchkontext bereit.

[out] ppszColumnName

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

Rückgabewert

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

Weitere Rückgabewerte finden Sie unter ADSI-Fehlercodes.

Hinweise

Diese Methode weist ausreichend Arbeitsspeicher für den Spaltennamen zu, aber der Aufrufer muss die FreeADsMem-Hilfsfunktion aufrufen, um diesen Arbeitsspeicher 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