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

# 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。若要获取扩展错误信息，请调用 [GetLastError](https://msdn.microsoft.com/library/windows/desktop/ms679360\(v=vs.85\).aspx)。

## 备注

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

## 要求

**头文件：** xmem.h

**库：** xmem.lib

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

## 另请参阅

[xmem 成员](https://docs.xbox.com/zh-CN/reference/system/xmem/xmem_members.md)


## Related topics

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