> ## 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.

# PFSegmentsServerGetPlayersInSegmentAsync

> Permite paginar por todos los jugadores de un segmento determinado. Esta API crea una instantánea de todos los perfiles de jugador que coinciden con la definición del segmento en el momento de.

Permite paginar por todos los jugadores de un segmento determinado. Esta API crea una instantánea de todos los perfiles de jugador que coinciden con la definición del segmento en el momento de su creación y se mantiene durante el tiempo total de vida en segundos (Total Seconds to Live), actualizando su período de vida con cada uso posterior del Continuation Token. Los perfiles que cambien durante el transcurso de la paginación no se reflejarán en los resultados. Actualmente, esta operación no admite segmentos de pruebas AB. NOTA: Esta API está limitada a 30 llamadas por minuto. Se le devolverá un error si supera este umbral.

## Sintaxis

```cpp theme={null}
HRESULT PFSegmentsServerGetPlayersInSegmentAsync(  
    PFEntityHandle titleEntityHandle,  
    const PFSegmentsGetPlayersInSegmentRequest* request,  
    XAsyncBlock* async  
)  
```

### Parámetros

**`titleEntityHandle`**   PFEntityHandle

PFEntityHandle para una entidad de título obtenida mediante PFAuthenticationGetEntityWithSecretKeyAsync.

**`request`**   [PFSegmentsGetPlayersInSegmentRequest\*](/services/playfab/api-references/c/pfsegmentstypes/structs/pfsegmentsgetplayersinsegmentrequest)

Objeto de solicitud rellenado.

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

XAsyncBlock para la operación asincrónica.

### Valor devuelto

Tipo: HRESULT

Código de resultado de esta operación de API.

## Comentarios

Esta API está disponible en Win32, Linux y macOS. La solicitud inicial debe contener al menos un Segment ID. Las solicitudes posteriores deben contener el Segment ID además del Continuation Token. Si no se envía el Continuation Token, se generará una nueva lista de segmentos de jugadores. Cada vez que se pasa el Continuation Token, se actualiza la duración del tiempo total de vida en segundos (Total Seconds to Live). Si transcurre demasiado tiempo entre solicitudes, hasta el punto de que una solicitud posterior supere el tiempo total de vida en segundos, se devolverá un error y se terminará la paginación. Esta API consume muchos recursos y no debe usarse en escenarios que puedan generar volúmenes elevados de solicitudes. Solo se debe realizar una solicitud a esta API a la vez por título. Las solicitudes simultáneas a la API pueden rechazarse con el error APIConcurrentRequestLimitExceeded. Vea también ServerGetAllSegmentsAsync. Cuando se complete la tarea asincrónica, llame a [PFSegmentsServerGetPlayersInSegmentGetResultSize](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersinsegmentgetresultsize) y a [PFSegmentsServerGetPlayersInSegmentGetResult](/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersinsegmentgetresult) para obtener el resultado.

## Requisitos

**Encabezado:** PFSegments.h

## Consulte también

[Miembros de PFSegments](/services/playfab/api-references/c/pfsegments/pfsegments_members)


## Related topics

- [PFSegmentsServerGetPlayersInSegmentGetResult](/es/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersinsegmentgetresult.md)
- [Información general de la API de C de Services - PFSegments.h](/es/services/playfab/api-references/c/pfsegments/pfsegments_members.md)
- [PFSegmentsServerGetPlayerSegmentsAsync](/es/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersegmentsasync.md)
- [PFSegmentsServerGetPlayerSegmentsGetResult](/es/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersegmentsgetresult.md)
- [PFSegmentsServerGetAllSegmentsAsync](/es/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetallsegmentsasync.md)