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

Recupera o nome de um heap Win32

## Sintaxe

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

### Parâmetros

*Heap*   \_In\_\
Tipo: HANDLE

Identificador do heap

*Buffer*   \_Out\_\
Tipo: PCSTR

Buffer no qual o nome do heap será retornado

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

Tamanho em bytes de Buffer

*ReturnLength*   \_Out\_opt\_\
Tipo: PSIZE\_T

Número de bytes retornados, incluindo o terminador NULL

### Valor retornado

Tipo: BOOL

Em caso de êxito, XMemGetWin32HeapName 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.  XMemGetWin32HeapName sempre terminará com NULL o buffer fornecido em caso de êxito.  Para garantir que o nome completo seja recuperado, forneça um buffer de pelo menos 9 bytes.

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

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