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

# PFAuthenticationLoginWithSteamAsync

> Steam 인증 티켓을 사용하여 사용자를 로그인시키고, 이후 인증된 사용자가 필요한 API 호출에 사용할 수 있는 세션 식별자를 반환합니다.

Steam 인증 티켓을 사용하여 사용자를 로그인시키고, 인증된 사용자가 필요한 이후 API 호출에 사용할 수 있는 세션 식별자를 반환합니다.

## 구문

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

### 매개 변수

**`serviceConfigHandle`**   PFServiceConfigHandle

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

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

채워진 요청 객체입니다.

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

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

### 반환 값

형식: HRESULT

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

## 설명

이 API는 Win32, Linux 및 macOS에서 사용할 수 있습니다. Steam 로그인은 Steam Session Ticket을 통해 수행됩니다. Ticket에 대한 자세한 내용은 Steamworks SDK의 [https://partner.steamgames.com/documentation/auth](https://partner.steamgames.com/documentation/auth)에서 확인할 수 있습니다. 참고: Steam 인증이 작동하려면 PlayFab Game Manager에서 타이틀이 Steam Application ID 및 Web API Key로 구성되어 있어야 합니다(Add-ons Marketplace의 Steam에서). App ID와 연결된 그룹의 Permissions 페이지에서 Steamworks 사이트를 통해 Web API Key를 얻을 수 있습니다. 사용자가 Steam 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 제공된 계정의 Steam ID에 연결됩니다. 이 경우 PlayFab 계정에는 이메일이나 사용자 이름이 연결되지 않습니다. 그렇지 않고 Steam 계정에 연결된 PlayFab 계정이 없으면, 이를 나타내는 오류가 반환되어 타이틀이 사용자에게 PlayFab 계정 생성 과정을 안내할 수 있도록 합니다. ClientLinkSteamAccountAsync, ClientUnlinkSteamAccountAsync도 참조하세요. 비동기 작업이 완료되면 [PFAuthenticationLoginWithSteamGetResult](/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithsteamgetresult)를 호출하여 결과를 가져옵니다.

## 요구 사항

**헤더:** PFAuthentication.h

## 참고 항목

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


## Related topics

- [PFAuthenticationLoginWithSteamGetResultSize](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithsteamgetresultsize.md)
- [PFAuthenticationLoginWithSteamGetResult](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithsteamgetresult.md)
- [빠른 시작 (Windows) - Core SDK 설정](/ko/services/playfab/sdks/unified-sdk/quickstart-core.md)
- [Services C API 개요 - PFAuthentication.h](/ko/services/playfab/api-references/c/pfauthentication/pfauthentication_members.md)
- [빠른 시작 Win32](/ko/services/playfab/sdks/c/quickstart-win32.md)