> ## 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 el nombre de un montón Win32

## Sintaxis

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

### Parámetros

*Heap*   \_In\_\
Tipo: HANDLE

Identificador del montón

*Buffer*   \_Out\_\
Tipo: PCSTR

Búfer en el que se devuelve el nombre del montón

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

Tamaño en bytes de Buffer

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

Número de bytes devueltos, incluido el terminador NULL

### Valor devuelto

Tipo: BOOL

Si se ejecuta correctamente, XMemGetWin32HeapName devuelve TRUE. Si la función no se ejecuta correctamente, el valor devuelto es FALSE.  Para obtener información de error extendida, llame a <a href="https://msdn.microsoft.com/library/windows/desktop/ms679360(v=vs.85).aspx">GetLastError</a>.

## Comentarios

El nombre del montón está limitado a 8 caracteres, sin incluir el terminador NULL.  XMemGetWin32HeapName siempre agregará el terminador NULL al búfer proporcionado cuando la operación se realice correctamente.  Para garantizar que se recupere el nombre completo, proporcione un búfer de al menos 9 bytes.

## Requisitos

**Encabezado:** xmem.h

**Biblioteca:** xmem.lib

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Miembros de xmem](/reference/system/xmem/xmem_members)


## Related topics

- [XMemSetWin32HeapName](/es/reference/system/xmem/functions/xmemsetwin32heapname.md)
- [XMemGetWin32HeapStatistics](/es/reference/system/xmem/functions/xmemgetwin32heapstatistics.md)
- [WIN32_HEAP_STATISTICS](/es/reference/system/xmem/structs/win32_heap_statistics.md)
- [XMemCreateWin32Heap](/es/reference/system/xmem/functions/xmemcreatewin32heap.md)
- [XMemSetWin32HeapTrackingHooks](/es/reference/system/xmem/functions/xmemsetwin32heaptrackinghooks.md)