LocalSize 함수(winbase.h)

지정된 로컬 메모리 개체의 현재 크기(바이트)를 검색합니다.

참고 로컬 함수는 오버헤드가 더 크고 다른 메모리 관리 함수보다 더 적은 기능을 제공합니다. 설명서에서 로컬 함수를 사용해야 한다고 명시하지 않는 한 새 애플리케이션은 힙 함수를 사용해야 합니다. 자세한 내용은 전역 및 로컬 함수를 참조하세요.

구문

SIZE_T LocalSize(
  [in] HLOCAL hMem
);

[in] hMem

로컬 메모리 개체에 대한 핸들입니다. 이 핸들은 LocalAlloc, LocalReAlloc 또는 LocalHandle 함수에서 반환됩니다.

함수가 성공하면 반환 값은 지정된 로컬 메모리 개체의 크기(바이트)입니다. 지정된 핸들이 유효하지 않거나 개체가 삭제된 경우 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

메모리 블록의 크기는 메모리가 할당될 때 요청된 크기보다 클 수 있습니다.

지정된 개체의 메모리 블록이 삭제되지 않은지 확인하려면 LocalSize를 호출하기 전에 LocalFlags 함수를 호출합니다.