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

Win32 힙의 이름을 검색합니다.

## 구문

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

### 매개 변수

*Heap*   \_In\_\
형식: HANDLE

힙 핸들

*Buffer*   \_Out\_\
형식: PCSTR

힙 이름을 반환할 버퍼

*SizeOfBuffer*   \_In\_\
형식: SIZE\_T

Buffer의 크기(바이트)

*ReturnLength*   \_Out\_opt\_\
형식: PSIZE\_T

NULL 종결자를 포함하여 반환된 바이트 수

### 반환 값

형식: BOOL

성공하면 XMemGetWin32HeapName은 TRUE를 반환합니다. 함수가 실패하면 반환 값은 FALSE입니다. 확장 오류 정보를 가져오려면 <a href="https://msdn.microsoft.com/library/windows/desktop/ms679360(v=vs.85).aspx">GetLastError</a>를 호출하세요.

## 설명

힙 이름은 NULL 종결자를 포함하지 않고 8자로 제한됩니다. XMemGetWin32HeapName은 성공 시 항상 제공된 버퍼를 NULL로 종결합니다. 전체 이름이 검색되도록 하려면 최소 9바이트 크기의 버퍼를 제공하세요.

## 요구 사항

**헤더:** xmem.h

**라이브러리:** xmem.lib

**지원 플랫폼:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[xmem members](/reference/system/xmem/xmem_members)


## Related topics

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