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

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

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

## 구문

```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](/reference/remoting/functions/wdlaunchremotegame)으로 게임을 실행하는 데 현재 등록이 필요하지 않습니다. 향후 버전에서 이 함수가 완전히 구현되면 XBOX 서비스 또는 OGAT 패키징을 사용하는 게임을 실행하기 전에 등록이 필요합니다.</Note>

## 요구 사항

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

## 함께 보기

* [WdLaunchRemoteGame](/reference/remoting/functions/wdlaunchremotegame)
* [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)
* [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes)
* [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members)


## Related topics

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