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

# XAppCaptureCancelUserRecord

> XAppCaptureCancelUserRecord

# XAppCaptureCancelUserRecord

停止通过 [XAppCaptureStartUserRecord](/reference/system/xappcapture/functions/xappcapturestartuserrecord) 启动、并由输入的 ID 指定的正在进行的用户录制。用户不会收到指示录制已停止的通知，录制内容也不会保存到磁盘。将在未来版本中添加 Windows 对此 API 的支持。

## 语法

```cpp theme={null}
HRESULT XAppCaptureCancelUserRecord(
    const char* localId
)
```

### 参数

*localId* \_In\_\
类型：const char\*

表示请求录制的用户的句柄。

### 返回值

类型：HRESULT

函数结果。对于非 `S_OK` 的返回值，请参阅 [XAppCapture 错误代码](/reference/system/xappcapture/xappcapture_errors)。

## 备注

假定 localIdOfUserRecording 保存的是由 [XAppCaptureStartUserRecord](/reference/system/xappcapture/functions/xappcapturestartuserrecord) 返回的本地 ID。

```cpp theme={null}

if (FAILED_LOG(XAppCaptureCancelUserRecord(localIdOfUserRecording)))
{
    return;
}

appLog.AddLog("Recording cancelled: localId = %s\n", localIdOfUserRecording);

```

## 要求

**头文件：** XAppCapture.h

**库：** xgameruntime.lib

**支持的平台：** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[XAppCapture 成员](/reference/system/xappcapture/xappcapture_members)


## Related topics

- [XAppCaptureStartUserRecord](/zh-CN/reference/system/xappcapture/functions/xappcapturestartuserrecord.md)
- [XAppCapture](/zh-CN/reference/system/xappcapture/xappcapture_members.md)
- [XAppCaptureStopUserRecord](/zh-CN/reference/system/xappcapture/functions/xappcapturestopuserrecord.md)
- [XAppCaptureUserRecordingResult](/zh-CN/reference/system/xappcapture/structs/xappcaptureuserrecordingresult.md)
- [XAppCaptureRecordTimespan](/zh-CN/reference/system/xappcapture/functions/xappcapturerecordtimespan.md)