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

원격 기기에 게임을 등록합니다.

> [!NOTE]
>
> `WdRegisterRemoteXboxGame`은 현재 구현되지 않았으며 호출 시 S\_OK를 반환합니다. 향후 API 버전에서 추가될 예정입니다.

## 구문

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

### 매개 변수

`_In_z_ remoteDevice`\
형식: **const char\***

원격 기기의 호스트 이름 또는 IP 주소입니다(예: `"192.168.1.100"` 또는 `"MyDevKit"`).

`_In_z_ remoteFolderPath`\
형식: **const char\***

등록할 게임이 있는 원격 기기의 폴더 경로입니다(예: `"D:\\Games\\MyGame"` 또는 공통 루트를 사용할 때는 `"MyGame"`). `remoteFolderPath`가 절대 경로이면 `commonRootAlias`는 무시됩니다.

`_In_opt_z_ commonRootAlias`\
형식: **const char\***

선택 사항. 원격 기기의 공통 루트 디렉터리에 대한 별칭입니다. 기본 공통 루트 위치를 사용하려면 `nullptr`을 전달하세요.

### 반환 값

형식: **HRESULT**

성공 시 `S_OK`를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

#### 오류 코드

| 코드 | 값 | 설명 | 근본 원인 | 문제 해결 |
| - | - | - | - | - |
| E\_CONNECTIONERROR | 0x8C114014 | 연결 오류입니다. | 네트워크 연결을 설정할 때의 일반적인 실패(전송 계층 오류)이며, IP 주소 유효성이나 원격 컴퓨터 이름 확인과는 무관합니다. | 네트워크 연결, 방화벽 규칙, 원격 컴퓨터의 서비스 가용성을 확인합니다. 기기 간 가시성을 확인하고, 서로 ping이 가능해야 합니다. 로깅을 활성화한 상태에서 연결을 다시 시도합니다. |
| E\_NAMERESOLUTIONFAILED | 0x8C114012 | 원격 컴퓨터 이름을 확인할 수 없습니다. | DNS 또는 로컬 이름 확인을 통해 호스트 이름을 확인할 수 없습니다. | 호스트 이름 철자, DNS 구성 및 네트워크 연결을 확인합니다. 이름 확인 문제를 분리하려면 IP 주소를 사용합니다. |
| E\_INVALIDADDRESS | 0x8C114013 | 잘못된 주소입니다. | 잘못되었거나 형식이 맞지 않거나 지원되지 않는 네트워크 주소가 제공되었습니다(예: 잘못된 IP 형식, 잘못된 IP 또는 지원되지 않는 프로토콜). | 올바른 IP 주소인지 확인합니다. 주소 형식을 수정하고 IPv4 프로토콜을 사용하는지 확인합니다. |
| E\_CLIENTNOTAUTHORIZED | 0x8C114008 | 기기가 클라이언트를 거부했습니다. | 클라이언트가 기기의 신뢰할 수 있는 클라이언트 목록에 없습니다. 페어링 프로세스를 완료하기 전에 연결 시도가 시작되었습니다. | pin 페어링 프로세스를 성공적으로 완료합니다. 연결 요청을 다시 실행합니다. |
| E\_SERVERNOTAUTHORIZED | 0x8C114009 | 클라이언트가 기기를 거부했습니다. | 대상 기기가 클라이언트의 신뢰할 수 있는 엔드포인트 목록에 없습니다. 페어링 프로세스를 완료하기 전에 연결 시도가 시작되었습니다. | pin 페어링 프로세스를 성공적으로 완료합니다. 연결 요청을 다시 실행합니다. |
| E\_ADMIN\_REQUIRED | 0x8C114016 | 관리자 권한이 필요합니다. | 엔드포인트가 상승된 권한으로 실행 중이 아니며 작업에 관리자 수준 권한이 필요합니다. | 관리자로 엔드포인트를 다시 실행합니다. |

## 설명

`WdRegisterRemoteXboxGame`은 원격 기기에 배포된 게임 패키지를 등록하기 위한 함수입니다. `remoteFolderPath`는 유효한 게임 패키지를 포함하는 폴더를 가리켜야 합니다.

> [!NOTE]
>
> [WdLaunchRemoteGame](https://docs.xbox.com/ko/reference/remoting/functions/wdlaunchremotegame.md)으로 게임을 실행하는 데 현재 등록이 필요하지 않습니다. 향후 버전에서 이 함수가 완전히 구현되면 XBOX 서비스 또는 OGAT 패키징을 사용하는 게임을 실행하기 전에 등록이 필요합니다.

## 요구 사항

| 요구 사항 | 값 |
| - | - |
| **헤더** | WdRemoteIteration.h |
| **라이브러리** | wdremoteapi.lib |
| **지원 OS** | Windows 11 이상 |
| **지원 아키텍처** | x64, ARM64 |

## 함께 보기

* [WdLaunchRemoteGame](https://docs.xbox.com/ko/reference/remoting/functions/wdlaunchremotegame.md)
* [WdRemoteCopy](https://docs.xbox.com/ko/reference/remoting/functions/wdremotecopy.md)
* [XBOX PC Remote Iteration API 오류 코드](https://docs.xbox.com/ko/reference/remoting/error-codes.md)
* [XBOX PC Remote Iteration API](https://docs.xbox.com/ko/reference/remoting/remoteiteration_members.md)


## Related topics

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