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

# XMemSetWin32HeapName

> XMemSetWin32HeapName

# XMemSetWin32HeapName

设置 Win32 堆的名称。

## 语法

```cpp theme={null}
BOOL XMemSetWin32HeapName(
  HANDLE Heap,
  PCSTR Buffer,
  SIZE_T SizeOfBuffer
)
```

### 参数

*Heap*   \_In\_\
类型：HANDLE

堆句柄。

*Buffer*   \_In\_\
类型：PCSTR

包含要设置的名称的缓冲区。

*SizeOfBuffer*   \_In\_\
类型：SIZE\_T

Buffer 的大小（以字节为单位）。

### 返回值

类型：BOOL

成功时，XMemSetWin32HeapName 返回 TRUE。如果函数失败，则返回值为 FALSE。若要获取扩展错误信息，请调用 <a href="https://msdn.microsoft.com/library/windows/desktop/ms679360(v=vs.85).aspx">GetLastError</a>。

## 备注

堆名称限制为 8 个字符（不包括 NULL 终止符）。XMemSetWin32HeapName 将根据字符数限制截断所提供的名称。

## 要求

**头文件：** xmem.h

**库：** xmem.lib

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

## 另请参阅

[xmem 成员](/reference/system/xmem/xmem_members)


## Related topics

- [XMemGetWin32HeapName](/zh-CN/reference/system/xmem/functions/xmemgetwin32heapname.md)
- [XMemSetWin32HeapTrackingHooks](/zh-CN/reference/system/xmem/functions/xmemsetwin32heaptrackinghooks.md)
- [XMemCreateWin32Heap](/zh-CN/reference/system/xmem/functions/xmemcreatewin32heap.md)
- [WIN32_HEAP_STATISTICS](/zh-CN/reference/system/xmem/structs/win32_heap_statistics.md)
- [XMemGetWin32HeapStatistics](/zh-CN/reference/system/xmem/functions/xmemgetwin32heapstatistics.md)