GetRegionData 함수(wingdi.h)

GetRegionData 함수는 지정된 버퍼를 지역을 설명하는 데이터로 채웁니다. 이 데이터에는 지역을 구성하는 사각형의 차원이 포함됩니다.

구문

DWORD GetRegionData(
  [in]  HRGN      hrgn,
  [in]  DWORD     nCount,
  [out] LPRGNDATA lpRgnData
);

[in] hrgn

지역에 대한 핸들입니다.

[in] nCount

lpRgnData 버퍼의 크기(바이트)입니다.

[out] lpRgnData

정보를 수신하는 RGNDATA 구조체에 대한 포인터입니다. 영역의 차원은 논리 단위입니다. 이 매개 변수가 NULL인 경우 반환 값에는 지역 데이터에 필요한 바이트 수가 포함됩니다.

함수가 성공하고 nCount 가 적절한 바이트 수를 지정하는 경우 반환 값은 사용된 실제 바이트 수( nCount보다 작거나 같음)와 같습니다.

lpRgnData가 NULL인 경우 반환 값은 필요한 바이트 수입니다.

함수가 실패하면 반환 값은 0입니다.

hrgn이 잘못되어 오류가 발생하면 GetLastError는 ERROR_INVALID_HANDLE 반환합니다. 그렇지 않으면 GetLastError 는 ERROR_INVALID_PARAMETER 반환합니다.

nCount가 너무 작으면 함수가 실패합니다.

GetRegionData 함수는 ExtCreateRegion 함수와 함께 사용됩니다.

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