> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFCatalogSearchItemsAsync

> Executa uma pesquisa no catálogo público usando os parâmetros de pesquisa fornecidos e retorna um conjunto de resultados paginados. SearchItems usa um cache do catálogo, e as atualizações de itens podem levar alguns minutos para serem propagadas. Você deve usar a API GetItem ao tentar obter imediatamente atualizações recentes de itens. Mais informações sobre a API Search podem ser encontradas aqui: https://learn.microsoft.com/gaming/playfab/features/economy-v2/catalog/search

Executa uma pesquisa no catálogo público usando os parâmetros de pesquisa fornecidos e retorna um conjunto de resultados paginados. SearchItems usa um cache do catálogo, e as atualizações de itens podem levar alguns minutos para serem propagadas. Você deve usar a API GetItem ao tentar obter imediatamente atualizações recentes de itens. Mais informações sobre a API Search podem ser encontradas aqui: [https://learn.microsoft.com/gaming/playfab/features/economy-v2/catalog/search](https://learn.microsoft.com/gaming/playfab/features/economy-v2/catalog/search)

## Sintaxe

```cpp theme={null}
HRESULT PFCatalogSearchItemsAsync(  
    PFEntityHandle entityHandle,  
    const PFCatalogSearchItemsRequest* request,  
    XAsyncBlock* async  
)  
```

### Parâmetros

**`entityHandle`**   PFEntityHandle

PFEntityHandle a ser usado para autenticação.

**`request`**   [PFCatalogSearchItemsRequest\*](/pt-BR/services/playfab/api-references/c/pfcatalogtypes/structs/pfcatalogsearchitemsrequest)

Objeto de solicitação preenchido.

**`async`**   XAsyncBlock\*<br />*Inout*

XAsyncBlock para a operação assíncrona.

### Valor de retorno

Tipo: HRESULT

Código de resultado desta operação de API.

## Comentários

Esta API está disponível em todas as plataformas. Quando a tarefa assíncrona for concluída, chame [PFCatalogSearchItemsGetResultSize](/pt-BR/services/playfab/api-references/c/pfcatalog/functions/pfcatalogsearchitemsgetresultsize) e [PFCatalogSearchItemsGetResult](/pt-BR/services/playfab/api-references/c/pfcatalog/functions/pfcatalogsearchitemsgetresult) para obter o resultado.

## Requisitos

**Cabeçalho:** PFCatalog.h

## Confira também

[Membros de PFCatalog](/pt-BR/services/playfab/api-references/c/pfcatalog/pfcatalog_members)


## Related topics

- [PFCatalogSearchItemsGetResult](/pt-BR/services/playfab/api-references/c/pfcatalog/functions/pfcatalogsearchitemsgetresult.md)
- [Visão geral da API C do Services - PFCatalog.h](/pt-BR/services/playfab/api-references/c/pfcatalog/pfcatalog_members.md)
- [PFCatalogSearchItemsGetResultSize](/pt-BR/services/playfab/api-references/c/pfcatalog/functions/pfcatalogsearchitemsgetresultsize.md)
- [PFCatalogSearchItemsRequest](/pt-BR/services/playfab/api-references/c/pfcatalogtypes/structs/pfcatalogsearchitemsrequest.md)
- [PFCatalogSearchItemsResponse](/pt-BR/services/playfab/api-references/c/pfcatalogtypes/structs/pfcatalogsearchitemsresponse.md)