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

# 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](/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresultsize) 获取所需的缓冲区大小。

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

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

*ptrToBufferResults*   \_Outptr\_\
类型：[XblMultiplayerActivityInfo\*\*](/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo)

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

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

`ptrToBufferResults` 数组中的条目数。

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

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

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

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

## 要求

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

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

## 另请参阅

[multiplayer\_activity\_c](/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members)


## Related topics

- [XblMultiplayerActivityGetActivityResultSize](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresultsize.md)
- [XblMultiplayerActivityInfo](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)
- [XblMultiplayerActivityGetActivityAsync](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityasync.md)
- [Multiplayer Activity 示例代码](/zh-CN/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)
- [从 MPSD 迁移到 PlayFab Multiplayer 和 MPA](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)