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


## Related topics

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