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

La méthode IDirectorySearch::GetNextColumnName obtient le nom de la colonne suivante dans le résultat de recherche qui contient des données.

Syntaxe

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

Paramètres

[in] hSearchHandle

Fournit un handle au contexte de recherche.

[out] ppszColumnName

Fournit l’adresse d’un pointeur vers une chaîne allouée par méthode contenant le nom de colonne demandé. Si la valeur est NULL, aucune ligne suivante ne contient de données.

Valeur retournée

Cette méthode retourne les valeurs de retour standard, ainsi que les éléments suivants :

Pour les autres valeurs de retour, consultez Codes d’erreur ADSI.

Notes

Cette méthode alloue suffisamment de mémoire pour le nom de colonne, mais l’appelant doit appeler la fonction d’assistance FreeADsMem pour libérer cette mémoire quand elle n’est plus nécessaire.

Exemples

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

Spécifications

Voir aussi

Codes d’erreur ADSI

FreeADsMem

IDirectorySearch