> ## 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-TW/reference/system/xmem/xmem_members.md)


## Related topics

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