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

# WdRegisterRemoteXboxGame

> WdRegisterRemoteXboxGame

# WdRegisterRemoteXboxGame

Registra un juego en un dispositivo remoto.

> [!NOTE]
>
> `WdRegisterRemoteXboxGame` no está implementada actualmente y devolverá S\_OK cuando se llame. Se agregará en una versión posterior de la API.

## Sintaxis

```cpp theme={null}
HRESULT WdRegisterRemoteXboxGame(  
         _In_z_ const char* remoteDevice,  
         _In_z_ const char* remoteFolderPath,  
         _In_opt_z_ const char* commonRootAlias  
);  
```

### Parámetros

`_In_z_ remoteDevice`\
Tipo: **const char\***

Nombre de host o dirección IP del dispositivo remoto (por ejemplo, `"192.168.1.100"` o `"MyDevKit"`).

`_In_z_ remoteFolderPath`\
Tipo: **const char\***

Ruta de acceso en el dispositivo remoto a la carpeta que contiene el juego que se va a registrar (por ejemplo, `"D:\\Games\\MyGame"` o `"MyGame"` cuando se usa una raíz común). Si `remoteFolderPath` es una ruta de acceso absoluta, `commonRootAlias` se omitirá.

`_In_opt_z_ commonRootAlias`\
Tipo: **const char\***

Opcional. Alias de un directorio raíz común en el dispositivo remoto. Pase `nullptr` para usar la ubicación de raíz común predeterminada.

### Valor devuelto

Tipo: **HRESULT**

Devuelve `S_OK` si se realiza correctamente; de lo contrario, devuelve un código de error.

#### Códigos de error

| Código | Valor | Descripción | Causa raíz | Solución de problemas |
| - | - | - | - | - |
| E\_CONNECTIONERROR | 0x8C114014 | Error de conexión. | Error genérico al establecer la conexión de red (error a nivel de transporte), no relacionado con la validez de la dirección IP ni con la resolución del nombre de la máquina remota | Compruebe la conectividad de red, las reglas de firewall y la disponibilidad del servicio en la máquina remota; compruebe la visibilidad entre dispositivos: deberían poder hacerse ping entre sí; reintente la conexión con el registro habilitado. |
| E\_NAMERESOLUTIONFAILED | 0x8C114012 | No se pudo resolver el nombre de la máquina remota. | El nombre de host no se puede resolver mediante DNS ni mediante resolución de nombres local. | Compruebe la ortografía del nombre de host, la configuración de DNS y la conectividad de red; use la dirección IP para aislar los problemas de resolución de nombres. |
| E\_INVALIDADDRESS | 0x8C114013 | Dirección no válida. | Se proporcionó una dirección de red incorrecta, con formato erróneo o no compatible (por ejemplo, un formato de IP incorrecto, una IP errónea o un protocolo no compatible). | Confirme la dirección IP correcta; corrija el formato de la dirección y asegúrese de que use un protocolo IPv4 |
| E\_CLIENTNOTAUTHORIZED | 0x8C114008 | El dispositivo rechazó al cliente. | El cliente no está en la lista de clientes de confianza del dispositivo. El intento de conexión se inició antes de completar el proceso de emparejamiento | Complete correctamente el proceso de emparejamiento por PIN; ejecute de nuevo la solicitud de conexión |
| E\_SERVERNOTAUTHORIZED | 0x8C114009 | El cliente rechazó al dispositivo. | El dispositivo de destino no está en la lista de puntos de conexión de confianza del cliente. El intento de conexión se inició antes de completar el proceso de emparejamiento | Complete correctamente el proceso de emparejamiento por PIN; ejecute de nuevo la solicitud de conexión |
| E\_ADMIN\_REQUIRED | 0x8C114016 | Se requieren privilegios de administrador. | El punto de conexión no se está ejecutando con privilegios elevados y la operación requiere permisos de nivel de administrador | Vuelva a ejecutar el punto de conexión como administrador |

## Comentarios

`WdRegisterRemoteXboxGame` está pensada para registrar un paquete de juego implementado en el dispositivo remoto. `remoteFolderPath` debe apuntar a una carpeta que contenga un paquete de juego válido.

> [!NOTE]
>
> Actualmente no es necesario registrar el juego para iniciarlo con [WdLaunchRemoteGame](https://docs.xbox.com/es/reference/remoting/functions/wdlaunchremotegame.md). Cuando esta función esté completamente implementada en una versión futura, el registro será obligatorio antes de iniciar juegos que usen los servicios de XBOX o el empaquetado OGAT.

## Requisitos

| Requisito | Valor |
| - | - |
| **Encabezado** | WdRemoteIteration.h |
| **Biblioteca** | wdremoteapi.lib |
| **Sistemas operativos compatibles** | Windows 11 y versiones posteriores |
| **Arquitecturas compatibles** | x64, ARM64 |

## Consulte también

* [WdLaunchRemoteGame](https://docs.xbox.com/es/reference/remoting/functions/wdlaunchremotegame.md)
* [WdRemoteCopy](https://docs.xbox.com/es/reference/remoting/functions/wdremotecopy.md)
* [Códigos de error de la API XBOX PC Remote Iteration](https://docs.xbox.com/es/reference/remoting/error-codes.md)
* [API XBOX PC Remote Iteration](https://docs.xbox.com/es/reference/remoting/remoteiteration_members.md)


## Related topics

- [API XBOX PC Remote Iteration](https://docs.xbox.com/es/reference/remoting/remoteiteration_members.md)
- [WdLaunchRemoteGame](https://docs.xbox.com/es/reference/remoting/functions/wdlaunchremotegame.md)
- [WdResumeRemoteGame](https://docs.xbox.com/es/reference/remoting/functions/wdresumeremotegame.md)
- [WdTerminateRemoteGame](https://docs.xbox.com/es/reference/remoting/functions/wdterminateremotegame.md)
- [WdRemoteCopy](https://docs.xbox.com/es/reference/remoting/functions/wdremotecopy.md)