Metodo ISearchBoxInfo::GetCondition (shobjidl.h)

Articolo
08/26/2023

Recupera il contenuto della casella di ricerca come oggetto ICondition .

Sintassi

HRESULT GetCondition(
  [in]  REFIID riid,
  [out] void   **ppv
);

Parametri

[in] riid

Tipo: REFIID

Riferimento all'IID dell'interfaccia da recuperare tramite ppv, in genere IID_ICondition.

[out] ppv

Tipo: void**

Quando questo metodo restituisce correttamente, contiene il puntatore dell'interfaccia richiesto in riid. Questo è in genere ICondition.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Anziché la stringa di testo recuperata da ISearchBoxInfo::GetText, GetCondition recupera le stesse informazioni di un oggetto strutturato, i metodi di cui è possibile analizzare e modificare la stringa di ricerca.

È consigliabile usare la macro IID_PPV_ARGS definita in Objbase.h per creare il pacchetto dei parametri riid e ppv . Questa macro fornisce l'IID corretto in base all'interfaccia a cui punta il valore in ppv, che elimina la possibilità di un errore di codifica in riid che potrebbe causare risultati imprevisti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl.h

Vedi anche

ISearchBoxInfo

Condividi tramite