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

# XGameProtocolRegisterForActivation (en desuso)

> XGameProtocolRegisterForActivation (en desuso)

# XGameProtocolRegisterForActivation (en desuso)

> [!NOTE]
>
> Esta API está ahora en desuso. Use [XGameActivationRegisterForEvent](https://docs.xbox.com/es/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md) en su lugar.

Registra una devolución de llamada para la activación de protocolo.

## Sintaxis

```cpp theme={null}
STDAPI XGameProtocolRegisterForActivation(
    _In_opt_ XTaskQueueHandle queue,
    _In_opt_ void* context,
    _In_ XGameProtocolActivationCallback * callback,
    _Out_ XTaskQueueRegistrationToken* token
    ) noexcept;
```

### Parámetros

*queue*   \_In\_opt\_\
Tipo: XTaskQueueHandle

La cola de tareas que distribuye la devolución de llamada del evento.

*context*   \_In\_opt\_\
Tipo: void\*

El contexto que pasamos a la devolución de llamada del evento.

*callback*   \_In\_\
Tipo: XGameProtocolActivationCallback\*

La función de devolución de llamada del evento.

*token*   \_Out\_\
Tipo: [XTaskQueueRegistrationToken\*](https://docs.xbox.com/es/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)

Un token de la cola de tareas que representa el registro. Use el token para anular el registro de la devolución de llamada
para la activación de protocolo.

### Valor devuelto

Tipo: HRESULT

Código HRESULT de éxito o de error.\
Para obtener una lista de códigos de error, consulte [Códigos de error](https://docs.xbox.com/es/reference/errorcodes.md).

## Comentarios

\[!NOTE] No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más
información, consulte [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).

La función **XGameProtocolRegisterForActivation** usa una
[XGameProtocolActivationCallback](https://docs.xbox.com/es/reference/system/xgameprotocol/functions/xgameprotocolactivationcallback.md) como argumento.

Para anular el registro de una devolución de llamada para un evento de
invitación de juego, llame a [XGameProtocolUnregisterForEvent](https://docs.xbox.com/es/reference/system/xgameprotocol/functions/xgameprotocolunregisterforactivation.md).

## Requisitos

**Encabezado:** XGameProtocol.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Miembros de XGameProtocol](https://docs.xbox.com/es/reference/system/xgameprotocol/xgameprotocol_members.md)


## Related topics

- [XGameProtocolActivationCallbackXGameProtocol (en desuso)](https://docs.xbox.com/es/reference/system/xgameprotocol/functions/xgameprotocolactivationcallback.md)
- [XGameProtocol (en desuso)](https://docs.xbox.com/es/reference/system/xgameprotocol/xgameprotocol_members.md)
- [XGameProtocolUnregisterForActivation (en desuso)](https://docs.xbox.com/es/reference/system/xgameprotocol/functions/xgameprotocolunregisterforactivation.md)
- [XGameInviteRegisterForEvent (en desuso)](https://docs.xbox.com/es/reference/system/xgameinvite/functions/xgameinviteregisterforevent.md)
- [IGameInput::RegisterGuideButtonCallback (en desuso)](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)