> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerActivityGetActivityResult

> XblMultiplayerActivityGetActivityResult

# XblMultiplayerActivityGetActivityResult

获取成功的获取活动调用的结果。

## 语法

```cpp theme={null}
HRESULT XblMultiplayerActivityGetActivityResult(  
         XAsyncBlock* async,  
         size_t bufferSize,  
         void* buffer,  
         XblMultiplayerActivityInfo** ptrToBufferResults,  
         size_t* resultCount,  
         size_t* bufferUsed  
)  
```

### 参数

*async*   \_In\_\
类型：XAsyncBlock\*

此操作的 `XAsyncBlock`。

*bufferSize*   \_In\_\
类型：size\_t

结果缓冲区的大小。使用 [XblMultiplayerActivityGetActivityResultSize](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresultsize.md) 获取所需的缓冲区大小。

*buffer*   \_Out\_writes\_bytes\_to\_(bufferSize,*bufferUsed)\
类型：void*

接收结果的由调用方分配的字节缓冲区。

*ptrToBufferResults*   \_Outptr\_\
类型：[XblMultiplayerActivityInfo\*\*](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)

指向 `buffer` 内部的 [XblMultiplayerActivityInfo](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md) 强类型数组。请勿释放此数组。其生命周期与 `buffer` 相关联。

*resultCount*   \_Out\_\
类型：size\_t\*

`ptrToBufferResults` 数组中的条目数。

*bufferUsed*   \_Out\_opt\_\
类型：size\_t\*

`buffer` 中已使用的字节数。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

若要获取存储结果所需的缓冲区大小，请调用 [XblMultiplayerActivityGetActivityResultSize](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresultsize.md) 函数。\
\
 若要了解如何使用此函数，请参阅[Multiplayer Activity 的示例代码](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)的[活动](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md#activities)部分中的“获取活动”。\
\
 有关 Multiplayer Activity 的详细信息，请参阅[活动](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/mpa/concepts/live-mpa-activities.md)。

## 要求

**头文件：** multiplayer\_activity\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[multiplayer\_activity\_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members.md)


## Related topics

- [XblMultiplayerActivityGetActivityResultSize](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresultsize.md)
- [XblMultiplayerActivityInfo](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)
- [XblMultiplayerActivityGetActivityAsync](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityasync.md)
- [Multiplayer Activity 示例代码](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)
- [multiplayer_activity_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members.md)