> ## 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-TW/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-TW/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)

指向 `buffer` 的強型別 [XblMultiplayerActivityInfo](https://docs.xbox.com/zh-TW/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-TW/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresultsize.md) 函式。\
\
 若要了解此函式的使用方式，請參閱[多人遊戲活動的範例程式碼](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)中[活動](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md#activities)一節的「取得活動」。\
\
 如需多人遊戲活動的詳細資訊，請參閱[活動](https://docs.xbox.com/zh-TW/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-TW/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members.md)


## Related topics

- [XblMultiplayerActivityGetActivityResultSize](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresultsize.md)
- [XblMultiplayerActivityInfo](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)
- [XblMultiplayerActivityGetActivityAsync](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityasync.md)
- [multiplayer_activity_c](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members.md)
- [從 MPSD 移至 PlayFab Multiplayer 與 MPA](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)