énumération ADS_STATUSENUM (iads.h)
L’énumération ADS_STATUSENUM spécifie la status d’un ensemble de préférences de recherche avec la méthode IDirectorySearch ::SetSearchPreference.
Syntax
typedef enum __MIDL___MIDL_itf_ads_0000_0000_0019 {
ADS_STATUS_S_OK = 0,
ADS_STATUS_INVALID_SEARCHPREF,
ADS_STATUS_INVALID_SEARCHPREFVALUE
} ADS_STATUSENUM;
Constantes
ADS_STATUS_S_OK Valeur : 0 La préférence de recherche a été définie avec succès. |
ADS_STATUS_INVALID_SEARCHPREF La préférence de recherche spécifiée dans le membre dwSearchPref de la structure ADS_SEARCHPREF_INFO n’est pas valide. Les préférences de recherche doivent être extraites de l’énumération ADS_SEARCHPREF_ENUM . |
ADS_STATUS_INVALID_SEARCHPREFVALUE La valeur spécifiée dans le membre vValue de la structure ADS_SEARCHPREF_INFO n’est pas valide pour la préférence de recherche correspondante. |
Remarques
La méthode IDirectorySearch ::SetSearchPreference définit le membre dwStatusADS_SEARCHPREF_INFO structure sur l’une des valeurs ADS_STATUSENUM pour indiquer la status de la préférence de recherche correspondante. Les appelants peuvent utiliser cette valeur status pour décider s’il faut exécuter une recherche.
La valeur ADS_STATUS_INVALID_SEARCHPREF status peut être définie si vous définissez une préférence de recherche valide, mais cette préférence n’est pas prise en charge. Par exemple, si vous définissez ADS_SEARCHPREF_SORT_ON, mais que le serveur avec lequel vous communiquez ne prend pas en charge le contrôle de tri côté serveur LDAP, le membre dwStatus de la structure ADS_SEARCHPREF_INFO est défini sur ADS_STATUS_INVALID_SEARCHPREF par l’appel IDirectorySearch ::SetSearchPreference .
Exemples
L’exemple de code suivant montre comment utiliser l’énumération ADS_STATUSENUM avec la méthode IDirectorySearch ::SetSearchPreference pour déterminer le status d’une préférence de recherche.
/***************************************************************************
SetAndCheckSearchTimeout()
***************************************************************************/
HRESULT SetAndCheckSearchTimeout(IDirectorySearch *pSearch,
DWORD dwTimeout,
ADS_STATUSENUM *pStatus)
{
if(!pSearch || !pStatus)
{
return E_INVALIDARG;
}
HRESULT hr;
ADS_SEARCHPREF_INFO SearchPref;
SearchPref.dwSearchPref = ADS_SEARCHPREF_TIMEOUT;
SearchPref.vValue.dwType = ADSTYPE_INTEGER;
SearchPref.vValue.Integer = dwTimeout;
SearchPref.dwStatus = ADS_STATUS_S_OK;
hr = pSearch->SetSearchPreference(&SearchPref, 1);
if(S_OK != hr)
{
return hr;
}
*pStatus = SearchPref.dwStatus;
return S_OK;
}
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista |
Serveur minimal pris en charge | Windows Server 2008 |
En-tête | iads.h |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour