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

# PFAccountManagementServerLinkNintendoSwitchDeviceIdAsync

> Nintendo Switch 디바이스 식별자를 지정된 PlayFab 플레이어 계정에 연결하여 이후 세션에서 해당 디바이스로 로그인할 수 있도록 하는 서버 API입니다.

NintendoSwitchDeviceId를 사용자의 PlayFab 계정에 연결합니다.

## 구문

```cpp theme={null}
HRESULT PFAccountManagementServerLinkNintendoSwitchDeviceIdAsync(  
    PFEntityHandle titleEntityHandle,  
    const PFAccountManagementServerLinkNintendoSwitchDeviceIdRequest* request,  
    XAsyncBlock* async  
)  
```

### 매개 변수

**`titleEntityHandle`**   PFEntityHandle

PFAuthenticationGetEntityWithSecretKeyAsync를 사용하여 얻은 타이틀 Entity의 PFEntityHandle입니다.

**`request`**   [PFAccountManagementServerLinkNintendoSwitchDeviceIdRequest\*](/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementserverlinknintendoswitchdeviceidrequest)

채워진 요청 객체입니다.

**`async`**   XAsyncBlock\*<br />*Inout*

비동기 작업을 위한 XAsyncBlock입니다.

### 반환 값

형식: HRESULT

이 API 작업의 결과 코드입니다.

## 설명

이 API는 Win32, Linux 및 macOS에서 사용할 수 있습니다. ServerUnlinkNintendoSwitchDeviceIdAsync도 참조하세요. XAsyncGetStatus를 호출하여 작업의 상태를 가져옵니다. 서비스 호출이 실패하면 비동기 결과는 E\_PF\_LINKED\_ACCOUNT\_ALREADY\_CLAIMED 또는 전역 PlayFab 서비스 오류 중 하나가 됩니다. 오류 처리에 대한 자세한 내용은 “Handling PlayFab Errors” 문서 페이지를 참조하세요.

## 요구 사항

**헤더:** PFAccountManagement.h

## 참고 항목

[PFAccountManagement 멤버](/services/playfab/api-references/c/pfaccountmanagement/pfaccountmanagement_members)


## Related topics

- [PFAccountManagementServerLinkNintendoSwitchDeviceIdRequest](/ko/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementserverlinknintendoswitchdeviceidrequest.md)
- [PFAccountManagementServerUnlinkNintendoSwitchDeviceIdAsync](/ko/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementserverunlinknintendoswitchdeviceidasync.md)
- [PFAccountManagementClientLinkNintendoSwitchDeviceIdAsync](/ko/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementclientlinknintendoswitchdeviceidasync.md)
- [PFAccountManagementClientLinkNintendoSwitchDeviceIdRequest](/ko/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementclientlinknintendoswitchdeviceidrequest.md)
- [PFAccountManagementClientUnlinkNintendoSwitchDeviceIdAsync](/ko/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementclientunlinknintendoswitchdeviceidasync.md)