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

# XblPresenceRecordGetDeviceRecords

> XblPresenceRecordGetDeviceRecords

# XblPresenceRecordGetDeviceRecords

取得與傳回之線上狀態記錄相關聯的裝置線上狀態記錄。

## 語法

```cpp theme={null}
HRESULT XblPresenceRecordGetDeviceRecords(  
         XblPresenceRecordHandle handle,  
         const XblPresenceDeviceRecord** deviceRecords,  
         size_t* deviceRecordsCount  
)  
```

### 參數

*handle*   \_In\_\
類型：[XblPresenceRecordHandle](/zh-TW/reference/live/xsapi-c/presence_c/handles/xblpresencerecordhandle)

從 GetPresence API 傳回之線上狀態記錄的控制代碼。

*deviceRecords*   \_Out\_\
類型：[XblPresenceDeviceRecord\*\*](/zh-TW/reference/live/xsapi-c/presence_c/structs/xblpresencedevicerecord)

傳回指向裝置線上狀態記錄陣列的指標。傳回之指標陣列的記憶體在 XblPresenceRecordHandle 物件的存留期間內 (直到其關閉為止) 都保持有效。

*deviceRecordsCount*   \_Out\_\
類型：size\_t\*

傳回所傳回陣列的大小。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 需求

**標頭：** presence\_c.h

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

## 另請參閱

[presence\_c](/zh-TW/reference/live/xsapi-c/presence_c/presence_c_members)


## Related topics

- [XblPresenceDeviceRecord](/zh-TW/reference/live/xsapi-c/presence_c/structs/xblpresencedevicerecord.md)
- [取得使用者的線上狀態](/zh-TW/services/xbox-services/community/presence/how-to/live-getting-a-users-presence.md)
- [XblPresenceTitleRecord](/zh-TW/reference/live/xsapi-c/presence_c/structs/xblpresencetitlerecord.md)
- [XblPresenceRecordGetXuid](/zh-TW/reference/live/xsapi-c/presence_c/functions/xblpresencerecordgetxuid.md)
- [XblPresenceRecordGetUserState](/zh-TW/reference/live/xsapi-c/presence_c/functions/xblpresencerecordgetuserstate.md)