GlobalFlags 함수(winbase.h)

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

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

 

구문

UINT GlobalFlags(
  [in] HGLOBAL hMem
);

매개 변수

[in] hMem

전역 메모리 개체에 대한 핸들입니다. 이 핸들은 GlobalAlloc 또는 GlobalReAlloc 함수에서 반환됩니다.

반환 값

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

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

설명

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

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

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

요구 사항

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

참고 항목

전역 및 로컬 함수

GlobalAlloc

GlobalDiscard

GlobalReAlloc

메모리 관리 함수