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

# XMemGetWin32HeapName

> XMemGetWin32HeapName

# XMemGetWin32HeapName

获取 Win32 堆的名称

## 语法

```cpp theme={null}
BOOL XMemGetWin32HeapName(
  HANDLE Heap,
  PSTR Buffer,
  SIZE_T SizeOfBuffer,
  PSIZE_T ReturnLength
)
```

### 参数

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

堆句柄

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

用于返回堆名称的缓冲区

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

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

*ReturnLength*   \_Out\_opt\_\
类型：PSIZE\_T

返回的字节数（包括 NULL 终止符）

### 返回值

类型：BOOL

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

## 备注

堆名称最多为 8 个字符（不包括 NULL 终止符）。成功时，XMemGetWin32HeapName 将始终以 NULL 终止所提供的缓冲区。为确保获取完整名称，请提供至少 9 字节的缓冲区。

## 要求

**标头：** xmem.h

**库：** xmem.lib

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

## 请参阅

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


## Related topics

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