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

# PFAccountManagementClientLinkNintendoSwitchDeviceIdAsync

> 인증된 플레이어의 PlayFab 계정에 Nintendo Switch 장치 식별자를 연결하여 향후 세션에서 해당 장치로 로그인할 수 있도록 하는 클라이언트 API입니다.

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

## 구문

```cpp theme={null}
HRESULT PFAccountManagementClientLinkNintendoSwitchDeviceIdAsync(  
    PFEntityHandle entityHandle,  
    const PFAccountManagementClientLinkNintendoSwitchDeviceIdRequest* request,  
    XAsyncBlock* async  
)  
```

### 매개 변수

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

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

채워진 요청 개체입니다.

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

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

### 반환 값

형식: HRESULT

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

## 설명

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

## 요구 사항

**헤더:** PFAccountManagement.h

## 참고 항목

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


## Related topics

- [Services C API 개요 - PFAccountManagement.h](/ko/services/playfab/api-references/c/pfaccountmanagement/pfaccountmanagement_members.md)
- [PFAccountManagementClientLinkNintendoSwitchDeviceIdRequest](/ko/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementclientlinknintendoswitchdeviceidrequest.md)
- [PFAccountManagementClientUnlinkNintendoSwitchDeviceIdAsync](/ko/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementclientunlinknintendoswitchdeviceidasync.md)
- [PFAccountManagementServerLinkNintendoSwitchDeviceIdAsync](/ko/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementserverlinknintendoswitchdeviceidasync.md)
- [PFAccountManagementServerLinkNintendoSwitchDeviceIdRequest](/ko/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementserverlinknintendoswitchdeviceidrequest.md)