> ## 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](/zh-TW/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresultsize) 取得所需的緩衝區大小。

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

由呼叫端配置、用來接收結果的位元組緩衝區。

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

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

## 需求

**標頭：** multiplayer\_activity\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

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


## Related topics

- [XblMultiplayerActivityGetActivityResult](/es/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresult.md)
- [XblMultiplayerActivityGetActivityResultSize](/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresultsize.md)