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

# PFAuthenticationLoginWithCustomIDAsync

> 타이틀이 생성한 사용자 지정 고유 식별자를 사용하여 사용자를 로그인하고, 인증된 사용자가 필요한 API 호출에 이후 사용할 수 있는 세션 식별자를 반환합니다.

타이틀이 생성한 사용자 지정 고유 식별자를 사용하여 사용자를 로그인하고, 인증된 사용자가 필요한 API 호출에 이후 사용할 수 있는 세션 식별자를 반환합니다.

## Syntax

```cpp theme={null}
HRESULT PFAuthenticationLoginWithCustomIDAsync(  
    PFServiceConfigHandle serviceConfigHandle,  
    const PFAuthenticationLoginWithCustomIDRequest* request,  
    XAsyncBlock* async  
)  
```

### Parameters

**`serviceConfigHandle`**   PFServiceConfigHandle

PFServiceConfigCreateHandle 호출에서 반환된 PFServiceConfigHandle입니다.

**`request`**   [PFAuthenticationLoginWithCustomIDRequest\*](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithcustomidrequest)

값이 채워진 요청 객체입니다.

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

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

### Return value

Type: HRESULT

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

## Remarks

이 API는 모든 플랫폼에서 사용할 수 있습니다. 개발자는 고객이 다른 고객이 이미 사용 중인 ID를 생성할 가능성이 극히 낮도록 보장하는 것이 좋습니다. 사용자가 사용자 지정 ID로 처음 로그인하고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되고 사용자 지정 ID에 연결됩니다. 이 경우, 이메일이나 사용자 이름이 PlayFab 계정과 연결되지 않습니다. 그렇지 않고 사용자 지정 ID에 연결된 PlayFab 계정이 없는 경우, 이를 나타내는 오류가 반환되어 타이틀이 사용자에게 PlayFab 계정 생성을 안내할 수 있습니다. ClientLinkCustomIDAsync, ClientUnlinkCustomIDAsync도 참조하세요. 비동기 작업이 완료되면 [PFAuthenticationLoginWithCustomIDGetResult](/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithcustomidgetresult)를 호출하여 결과를 가져오세요.

## Requirements

**Header:** PFAuthentication.h

## See also

[PFAuthentication members](/services/playfab/api-references/c/pfauthentication/pfauthentication_members)


## Related topics

- [PFAuthenticationLoginWithCustomIDGetResultSize](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithcustomidgetresultsize.md)
- [PFAuthenticationLoginWithCustomIDGetResult](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithcustomidgetresult.md)
- [Services C API 개요 - PFAuthentication.h](/ko/services/playfab/api-references/c/pfauthentication/pfauthentication_members.md)
- [빠른 시작 Android](/ko/services/playfab/sdks/c/quickstart-android.md)
- [빠른 시작 Linux](/ko/services/playfab/sdks/c/quickstart-linux.md)