> ## 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 成員](/zh-TW/reference/system/xmem/xmem_members)


## Related topics

- [XMemGetWin32HeapName](/reference/system/xmem/functions/xmemgetwin32heapname.md)
- [XMemSetWin32HeapName](/reference/system/xmem/functions/xmemsetwin32heapname.md)