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
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | iads.h |
| DLL | Activeds.dll; Adsldp.dll; Adsldpc.dll |