GlobalSize 함수(winbase.h)
지정된 전역 메모리 개체의 현재 크기(바이트)를 검색합니다.
참고 전역 함수는 오버헤드가 더 크고 다른 메모리 관리 함수보다 적은 기능을 제공합니다. 설명서에서 전역 함수를 사용해야 한다고 명시하지 않는 한 새 애플리케이션은 힙 함수를 사용해야 합니다. 자세한 내용은 전역 및 로컬 함수를 참조하세요.
구문
SIZE_T GlobalSize(
[in] HGLOBAL hMem
);
매개 변수
[in] hMem
전역 메모리 개체에 대한 핸들입니다. 이 핸들은 GlobalAlloc 또는 GlobalReAlloc 함수에서 반환됩니다.
반환 값
함수가 성공하면 반환 값은 지정된 전역 메모리 개체의 크기(바이트)입니다.
지정된 핸들이 유효하지 않거나 개체가 삭제된 경우 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
메모리 블록의 크기는 메모리가 할당될 때 요청된 크기보다 클 수 있습니다.
지정한 개체의 메모리 블록이 삭제되지 않은지 확인하려면 GlobalSize를 호출하기 전에 GlobalFlags 함수를 사용합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows XP [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | winbase.h(Windows.h 포함) |
라이브러리 | Kernel32.lib |
DLL | Kernel32.dll |