Функция GetRegionData (wingdi.h)

Статья
01/30/2024

Функция 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, то возвращаемое значение — необходимое количество байтов.

Если функция завершается сбоем, возвращаемое значение равно нулю.

Если ошибка вызвана недопустимой ошибкой hrgn , метод GetLastError возвращает ERROR_INVALID_HANDLE. В противном случае GetLastError возвращает ERROR_INVALID_PARAMETER .

Если nCount слишком мал, функция завершается ошибкой.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll