# vx_req_account_buddy_set

> Learn how to set presence information.

Add a buddy to a buddy list or update the properties of a buddy.  [More...](#detailed-description)

`#include <VxcRequests.h>`

## Public Attributes

|                                                        | Name                                                                                                                                                                                                                      |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [vx\_req\_base\_t](./_vxc_8h.md#typedef-vx_req_base_t) | **[base](./structvx__req__account__buddy__set.md#variable-base)** The common properties for all requests.                                                                                                                 |
| [VX\_HANDLE](./_vxc_8h.md#typedef-vx_handle)           | **[account\_handle](./structvx__req__account__buddy__set.md#variable-account_handle)** The handle returned from a successful [vx\_req\_account\_anonymous\_login](./structvx__req__account__anonymous__login.md) request. |
| char \*                                                | **[buddy\_uri](./structvx__req__account__buddy__set.md#variable-buddy_uri)** The identifier of the buddy to add to the list.                                                                                              |
| char \*                                                | **[display\_name](./structvx__req__account__buddy__set.md#variable-display_name)** A readable name for display only.                                                                                                      |
| char \*                                                | **[buddy\_data](./structvx__req__account__buddy__set.md#variable-buddy_data)** A place to store extra data about a buddy.                                                                                                 |
| int                                                    | **[group\_id](./structvx__req__account__buddy__set.md#variable-group_id)** The ID of the group to add the buddy to.                                                                                                       |
| char \*                                                | **[message](./structvx__req__account__buddy__set.md#variable-message)**                                                                                                                                                   |

## Detailed Description

```cpp
struct vx_req_account_buddy_set;
```

Add a buddy to a buddy list or update the properties of a buddy.

**See**:

* [vx\_resp\_account\_buddy\_set](./structvx__resp__account__buddy__set.md)
* [vx\_evt\_subscription\_t](./_vxc_events_8h.md#typedef-vx_evt_subscription_t)

The buddy is added to the account implied by the account\_handle provided in the call. All relevant data about a buddy must be supplied when updating the buddy. If a display name is not specified when updating a the data field, the display name will be blank.

## Public Attributes Documentation

### variable base

```cpp
vx_req_base_t base;
```

The common properties for all requests.

### variable account\_handle

```cpp
VX_HANDLE account_handle;
```

The handle returned from a successful [vx\_req\_account\_anonymous\_login](./structvx__req__account__anonymous__login.md) request.

### variable buddy\_uri

```cpp
char * buddy_uri;
```

The identifier of the buddy to add to the list.

### variable display\_name

```cpp
char * display_name;
```

A readable name for display only.

**Note**: This is not required.

### variable buddy\_data

```cpp
char * buddy_data;
```

A place to store extra data about a buddy.

**Note**: This is not required.

### variable group\_id

```cpp
int group_id;
```

The ID of the group to add the buddy to.

To remove the buddy from a group, set this to 0.

### variable message

```cpp
char * message;
```

**Note**: This is optional. This is limited to a maximum of 256 characters.

**Attention**: This is not currently implemented. A personalized message that the user sees if they receive a vx\_evt\_subscription\_t event.