Metodo IOpenSearchSource::GetResults (shobjidl_core.h)

Articolo
08/26/2023

Restituisce i risultati della ricerca, da un'origine dati OpenSearch, formattata in formato RSS o Atom.

Sintassi

HRESULT GetResults(
  [in]  HWND    hwnd,
  [in]  LPCWSTR pszQuery,
  [in]  DWORD   dwStartIndex,
  [in]  DWORD   dwCount,
  [in]  REFIID  riid,
  [out] void    **ppv
);

Parametri

[in] hwnd

Tipo: HWND

Handle della finestra del chiamante.

[in] pszQuery

Tipo: LPCWSTR

Query immessa dall'utente. Questo parametro equivale al parametro OpenSearch {searchTerms} e può essere vuoto.

[in] dwStartIndex

Tipo: DWORD

Indice del primo risultato richiesto. Equivalente al parametro OpenSearch {startIndex}. Vedere Le osservazioni riportate di seguito.

[in] dwCount

Tipo: DWORD

Numero di risultati richiesti. Equivalente al parametro OpenSearch {count}.

[in] riid

Tipo: REFIID

ID dell'interfaccia richiesta. In genere IID_IStream.

[out] ppv

Tipo: void**

Puntatore dell'interfaccia, di tipo specificato da RIID, all'oggetto contenente i risultati in formato Atom o RSS.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario. B_S_ENDOFROWSET facoltativamente indica la fine dei risultati. Gli errori seguenti visualizzano i messaggi di errore appropriati nella barra delle informazioni:

INET_E_AUTHENTICATION_REQUIRED (l'utente non dispone dell'autorizzazione per accedere a questa risorsa)
INET_E_RESOURCE_NOT_FOUND (posizione non disponibile)
INET_E_DOWNLOAD_FAILURE (errore del server)

Commenti

Esplora risorse chiama questo metodo con i parametri di query di ricerca. L'implementazione di IOpenSearchSource restituisce alcuni o tutti i risultati dopo aver eseguito azioni necessarie, ad esempio fornendo l'interfaccia utente di autenticazione personalizzata o connettendosi all'origine dati usando un'API proprietaria.

Risultati paginati

Se non si vuole che il servizio Web restituisca più di un numero limitato di risultati per richiesta, questo metodo può restituire solo una "pagina" dei risultati alla volta. Esplora risorse può ottenere pagine aggiuntive di risultati chiamando ripetutamente questo metodo e specificando un nuovo numero di indice. Quando restituisce i risultati, il primo risultato deve essere il risultato dell'indice richiesto da dwStartIndex.

Numeri di indice e conteggi

Il numero di indice identifica il primo risultato in una pagina dei risultati. Equivale al parametro OpenSearch {startIndex}. Il conteggio, equivalente al parametro OpenSearch {count}, identifica il numero previsto o preferito di elementi restituiti per pagina.

Se un servizio Web restituisce 20 elementi nella prima pagina dei risultati, la dimensione prevista della pagina è 20. Per ottenere i 20 elementi successivi, Esplora risorse chiamerebbe IOpenSearchSource::GetResults con il valore 21 per dwStartIndex e con il valore 20 per dwCount. Quando una pagina dei risultati restituiti dal servizio Web ha meno elementi rispetto alle dimensioni della pagina previste, Esplora risorse presuppone che abbia ricevuto l'ultima pagina dei risultati e arresta le richieste.

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Vedi anche

IOpenSearchSource

Condividi tramite