LocalFlags 함수(winbase.h)

아티클
03/03/2024

지정된 로컬 메모리 개체에 대한 정보를 검색합니다.

참고 이 함수는 16비트 버전의 Windows와의 호환성을 위해서만 제공됩니다. 새 애플리케이션은 힙 함수를 사용해야 합니다. 자세한 내용은 설명 부분을 참조하세요.

구문

UINT LocalFlags(
  [in] HLOCAL hMem
);

매개 변수

[in] hMem

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

반환 값

함수가 성공하면 반환 값은 메모리 개체의 할당 값과 잠금 수를 지정합니다.

함수가 실패하면 반환 값이 LMEM_INVALID_HANDLE 로컬 핸들이 유효하지 않음을 나타냅니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

반환 값의 하위 순서 단어의 낮은 순서 바이트에는 개체의 잠금 수가 포함됩니다. 반환 값에서 잠금 수를 검색하려면 비트 AND( & ) 연산자와 함께 LMEM_LOCKCOUNT 마스크를 사용합니다. LMEM_FIXED 할당된 메모리 개체의 잠금 수는 항상 0입니다.

반환 값의 하위 순서 단어의 상위 바이트는 메모리 개체의 할당 값을 나타냅니다. 0이거나 LMEM_DISCARDABLE 수 있습니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winbase.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll