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

# PFFriendsClientAddFriendAsync

> 제공된 고유 식별자와의 일치를 기반으로 PlayFab 사용자를 로컬 사용자의 친구 목록에 추가합니다. 최소한 하나 이상.

제공된 고유 식별자와의 일치를 기반으로 PlayFab 사용자를 로컬 사용자의 친구 목록에 추가합니다. FriendPlayFabId, FriendUsername, FriendEmail 또는 FriendTitleDisplayName 중 최소한 하나 이상을 초기화해야 합니다.

## 구문

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

### 매개 변수

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

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

채워진 요청 개체입니다.

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

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

### 반환 값

형식: HRESULT

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

## 설명

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

## 요구 사항

**헤더:** PFFriends.h

## 참고 항목

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