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

# PFFriendsClientGetFriendsListAsync

> 로컬 사용자의 현재 친구 목록을 검색합니다. PlayFab 계정을 가진 사용자로 제한됩니다. 연결된 계정(Facebook, Steam)의 친구도 포함됩니다.

로컬 사용자의 현재 친구 목록을 검색합니다. PlayFab 계정을 가진 사용자로 제한됩니다. 연결된 계정(Facebook, Steam)의 친구도 포함됩니다. 일부 연결된 서비스의 친구를 선택적으로 제외할 수 있습니다.

## 구문

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

### 매개 변수

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

**`request`**   [PFFriendsClientGetFriendsListRequest\*](/services/playfab/api-references/c/pffriendstypes/structs/pffriendsclientgetfriendslistrequest)

채워진 요청 개체입니다.

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

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

### 반환 값

형식: HRESULT

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

## 설명

이 API는 모든 플랫폼에서 사용할 수 있습니다. ClientAddFriendAsync, ClientGetPlayerProfileAsync, ClientRemoveFriendAsync도 참조하세요. 비동기 작업이 완료되면 [PFFriendsClientGetFriendsListGetResultSize](/services/playfab/api-references/c/pffriends/functions/pffriendsclientgetfriendslistgetresultsize)와 [PFFriendsClientGetFriendsListGetResult](/services/playfab/api-references/c/pffriends/functions/pffriendsclientgetfriendslistgetresult)를 호출하여 결과를 가져옵니다.

## 요구 사항

**헤더:** PFFriends.h

## 참고 항목

[PFFriends 멤버](/services/playfab/api-references/c/pffriends/pffriends_members)


## Related topics

- [PFFriendsClientGetFriendsListGetResult](/ko/services/playfab/api-references/c/pffriends/functions/pffriendsclientgetfriendslistgetresult.md)
- [Services C API 개요 - PFFriends.h](/ko/services/playfab/api-references/c/pffriends/pffriends_members.md)
- [PFFriendsClientAddFriendAsync](/ko/services/playfab/api-references/c/pffriends/functions/pffriendsclientaddfriendasync.md)
- [PFFriendsClientGetFriendsListGetResultSize](/ko/services/playfab/api-references/c/pffriends/functions/pffriendsclientgetfriendslistgetresultsize.md)
- [PFFriendsClientGetFriendsListRequest](/ko/services/playfab/api-references/c/pffriendstypes/structs/pffriendsclientgetfriendslistrequest.md)