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

Define o nome de um heap Win32

## Sintaxe

```cpp theme={null}
BOOL XMemSetWin32HeapName(
  HANDLE Heap,
  PCSTR Buffer,
  SIZE_T SizeOfBuffer
)
```

### Parâmetros

*Heap*   \_In\_\
Tipo: HANDLE

Identificador do heap

*Buffer*   \_In\_\
Tipo: PCSTR

Buffer que contém o nome a ser definido

*SizeOfBuffer*   \_In\_\
Tipo: SIZE\_T

Tamanho em bytes de Buffer

### Valor retornado

Tipo: BOOL

Em caso de êxito, XMemSetWin32HeapName retorna TRUE. Se a função falhar, o valor retornado será FALSE.  Para obter informações de erro estendidas, chame <a href="https://msdn.microsoft.com/library/windows/desktop/ms679360(v=vs.85).aspx">GetLastError</a>.

## Comentários

O nome do heap é limitado a 8 caracteres, sem incluir o terminador NULL.  XMemSetWin32HeapName truncará o nome fornecido no limite de caracteres.

## Requisitos

**Cabeçalho:** xmem.h

**Biblioteca:** xmem.lib

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[Membros de xmem](/pt-BR/reference/system/xmem/xmem_members)


## Related topics

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