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

# XGameActivationInfo

> XGameActivationInfo

# XGameActivationInfo

활성화 콜백에 전달되는 활성화 정보를 포함합니다.

## 구문

```cpp theme={null}
struct XGameActivationInfo  
{  
    XGameActivationType type;  
    union  
    {  
        const char* protocolUri;  
        const char* file;  
        const char* inviteUri;  
    };  
};  
```

### 멤버

*type*\
형식: [XGameActivationType](/reference/system/xgameactivation/enums/xgameactivationtype)

발생한 활성화의 유형입니다. union의 어떤 필드에 유효한 데이터가 포함되는지 결정합니다.

*protocolUri*\
형식: const char\*

게임을 활성화한 프로토콜 URI입니다. `type`이 `XGameActivationType::Protocol`인 경우에 유효합니다.

*file*\
형식: const char\*

게임을 활성화한 파일 경로입니다. `type`이 `XGameActivationType::File`인 경우에 유효합니다.

*inviteUri*\
형식: const char\*

게임 세션에 대한 초대 URI입니다. `type`이 `XGameActivationType::PendingGameInvite` 또는 `XGameActivationType::AcceptedGameInvite`인 경우에 유효합니다.

## 설명

**XGameActivationInfo** 구조체는 활성화 이벤트가 발생할 때 [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback)에 전달됩니다. `type` 필드는 활성화 종류를 나타내며, 해당 union 필드에 관련 데이터가 포함됩니다.

활성화 유형이 `PendingGameInvite`인 경우, 게임은 사용자가 초대를 수락하거나 거부할 수 있는 UI를 표시해야 합니다. 사용자가 수락하면 `inviteUri`와 함께 [XGameActivationAcceptPendingInvite](/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite)를 호출합니다. 그러면 `AcceptedGameInvite` 유형의 후속 콜백이 트리거됩니다.

## 요구 사항

**헤더:** XGameActivation.h

**지원 플랫폼:** Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 개념 문서

* [파일 형식 활성화](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)
* [초대 받기](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## 함께 보기

[XGameActivation](/reference/system/xgameactivation/xgameactivation_members)\
[XGameActivationType](/reference/system/xgameactivation/enums/xgameactivationtype)\
[XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback)\
[XGameActivationAcceptPendingInvite](/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite)


## Related topics

- [XGameActivationCallback](/ko/reference/system/xgameactivation/functions/xgameactivationcallback.md)
- [XGameActivationType](/ko/reference/system/xgameactivation/enums/xgameactivationtype.md)
- [XGameActivation](/ko/reference/system/xgameactivation/xgameactivation_members.md)
- [XGameActivationAcceptPendingInvite](/ko/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite.md)
- [초대 받기](/ko/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)