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

# WdRegisterRemoteXboxGame

> WdRegisterRemoteXboxGame

# WdRegisterRemoteXboxGame

Registra un juego en un dispositivo remoto.

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

## 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](/reference/remoting/functions/wdlaunchremotegame). 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.</Note>

## 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](/reference/remoting/functions/wdlaunchremotegame)
* [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)
* [Códigos de error de la API XBOX PC Remote Iteration](/reference/remoting/error-codes)
* [API XBOX PC Remote Iteration](/reference/remoting/remoteiteration_members)


## Related topics

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