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

# XSystemGetXboxLiveSandboxId

> XSystemGetXboxLiveSandboxId

# XSystemGetXboxLiveSandboxId

XBOX Live 샌드박스 ID를 검색합니다.

## 구문

```cpp theme={null}
HRESULT XSystemGetXboxLiveSandboxId(  
         size_t sandboxIdSize,  
         char* sandboxId,  
         size_t* sandboxIdUsed  
)  
```

### 매개 변수

*sandboxIdSize*   \_In\_<br />형식: size\_t

\_sandboxId\_의 크기(바이트)입니다. 이 값은 XSystem.h에 정의된 **XSystemXboxLiveSandboxIdMaxBytes** 상수보다 크거나 같아야 합니다.

*sandboxId*   \_Out\_writes\_bytes\_to\_(sandboxIdSize,\*sandboxIdUsed)<br />형식: char\*

샌드박스 ID를 받을 문자 버퍼입니다.

*sandboxIdUsed*   \_Out\_opt\_<br />형식: size\_t\*

반환되는 *sandboxId* 버퍼의 실제 크기(바이트)입니다.

### 반환 값

형식: [HRESULT](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

성공하면 **S\_OK**를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 [오류 코드](/reference/errorcodes)를 참조하세요. \_sandboxIdSize\_가 **XSystemXboxLiveSandboxIdMaxBytes**보다 작은 값으로 설정되어 함수가 실패하는 경우, 반환 값은 \*\*HRESULT\_FROM\_WIN32(ERROR\_INSUFFICIENT\_BUFFER)\*\*로 설정됩니다.

## 설명

TitleID 및 SCID(서비스 구성 ID)와 함께 샌드박스 ID는 XBOX Live 타이틀 및 애플리케이션의 개발에 매우 중요합니다. 샌드박스 ID는 사용자의 샌드박스를 식별하며, 개발 중에 개발 키트에 대해 콘텐츠 격리를 제공합니다. 콘텐츠 격리를 통해 타이틀을 개발하고 테스트할 수 있는 깨끗한 환경이 보장됩니다.

<Note>
  샌드박스 ID는 대/소문자를 구분합니다.
</Note>

XBOX 및 PC 디바이스의 경우 샌드박스 ID가 디바이스에 저장되어 있습니다. 샌드박스 ID를 찾을 수 없거나 샌드박스 ID에 액세스할 권한이 없는 경우 샌드박스 ID는 기본적으로 'RETAIL'로 지정됩니다.

실제로 게임이 소매 환경에서 실행 중인 경우에도 이 함수는 'RETAIL'을 반환합니다.

## 요구 사항

**헤더:** XSystem.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 개념 문서

* [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 함께 보기

[개발 키트 설정 구성(NDA 주제)](/home/setup-install/dev-kit-settings/config-dev-kit-settings)<br />[XBOX Live 개발용 샌드박스 설정](/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes)<br />[XSystemGetConsoleId](/reference/system/xsystem/functions/xsystemgetconsoleid)<br />[XSystem](/reference/system/xsystem/xsystem_members)


## Related topics

- [콘솔 위치 확인](/ko/build/game-principles/localization/determining-console-geolocation.md)
- [XSystem](/ko/reference/system/xsystem/xsystem_members.md)
- [PFAccountManagementGetPlayFabIDsFromXboxLiveIDsRequest](/ko/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementgetplayfabidsfromxboxliveidsrequest.md)
- [PFAccountManagementGetTitlePlayersFromXboxLiveIDsRequest](/ko/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementgettitleplayersfromxboxliveidsrequest.md)
- [PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange](/ko/services/playfab/multiplayer/networking/xblreference/structs/partyxblgetentityidsfromxboxliveuseridscompletedstatechange.md)