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

# XSystemGetAppSpecificDeviceId

> XSystemGetAppSpecificDeviceId

# XSystemGetAppSpecificDeviceId

호출자의 타이틀 ID에 특정한 콘솔의 고유 값을 반환합니다.

## 구문

```cpp theme={null}
HRESULT XSystemGetAppSpecificDeviceId(  
         size_t appSpecificDeviceIdSize,  
         char* appSpecificDeviceId,  
         size_t* appSpecificDeviceIdUsed  
)  
```

### 매개 변수

*appSpecificDeviceIdSize*   \_In\_\
형식: size\_t

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

*appSpecificDeviceId*   \_Out\_writes\_bytes\_to\_(appSpecificDeviceIdSize, \*appSpecificDeviceIdUsed)\
형식: char\*

애플리케이션 특정 디바이스 ID를 받을 문자 버퍼입니다.

*appSpecificDeviceIdUsed*   \_Out\_opt\_\
형식: size\_t\*

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

### 반환 값

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

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

## 설명

<Note>이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 다음을 참조하세요.</Note>
[시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).

오류로 인해 애플리케이션 특정 디바이스 식별자를 가져올 수 없는 경우 상수 문자열 "00000000000000000000000000000000000000000000"이 반환됩니다.

애플리케이션이 SSO(Single-Sign-On)를 사용하는 경우 이 함수가 반환하는 ID 대신 XSTS SSO 토큰의 pairwise ID를
사용해야 합니다.

## 요구 사항

**헤더:** XSystem.h

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

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

## 함께 보기

[개발 키트 활성화(NDA 주제)](/home/setup-install/devkits/setup/activating-dev-kit)\
[XSystemGetXboxLiveSandbodId](/reference/system/xsystem/functions/xsystemgetxboxlivesandboxid)\
[XSystem](/reference/system/xsystem/xsystem_members)


## Related topics

- [XSystem](/ko/reference/system/xsystem/xsystem_members.md)
- [XSystemGetConsoleId](/ko/reference/system/xsystem/functions/xsystemgetconsoleid.md)
- [GDK용 Unity C# API 래퍼](/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [APP_LOCAL_DEVICE_ID](/ko/reference/system/xuser/structs/app_local_device_id.md)
- [ILampArray::GetDeviceId](/ko/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getdeviceid.md)