Méthode ISearchBoxInfo ::GetCondition (shobjidl.h)
Récupère le contenu de la zone de recherche en tant qu’objet ICondition .
Syntaxe
HRESULT GetCondition(
[in] REFIID riid,
[out] void **ppv
);
Paramètres
[in] riid
Type : REFIID
Référence à l’IID de l’interface à récupérer via ppv, généralement IID_ICondition.
[out] ppv
Type : void**
Lorsque cette méthode retourne correctement, contient le pointeur d’interface demandé dans riid. Il s’agit généralement d’ICondition.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Contrairement à la chaîne de texte récupérée par ISearchBoxInfo ::GetText, GetCondition récupère les mêmes informations qu’un objet structuré, dont les méthodes peuvent être utilisées pour analyser et manipuler la chaîne de recherche.
Nous vous recommandons d’utiliser la macro IID_PPV_ARGS , définie dans Objbase.h, pour empaqueter les paramètres riid et ppv . Cette macro fournit l’IID correct en fonction de l’interface pointée vers la valeur dans ppv, ce qui élimine la possibilité d’une erreur de codage dans riid qui pourrait entraîner des résultats inattendus.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shobjidl.h |