Функция LoadCursorFromFileA (winuser.h)

Создает курсор на основе данных, содержащихся в файле.

Примечание

Эта функция заменена функцией LoadImage (с установленными флагами LR_DEFAULTSIZE и LR_LOADFROMFILE ).

Синтаксис

HCURSOR LoadCursorFromFileA(
  [in] LPCSTR lpFileName
);

Параметры

[in] lpFileName

Тип: LPCTSTR

Источник файловых данных, используемых для создания курсора. Данные в файле должны находиться в . CUR или . Формат ANI.

Если слово высокого порядка lpFileName отличается от нуля, это указатель на строку, которая является полным именем файла, содержащего данные курсора.

Возвращаемое значение

Тип: HCURSOR

Если функция выполнена успешно, возвращаемое значение является дескриптором для нового курсора.

Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError. GetLastError может возвращать следующее значение.

Код возврата Описание
ERROR_FILE_NOT_FOUND
Не удается найти указанный файл.

Комментарии

Виртуализация DPI

Этот API не участвует в виртуализации DPI. На возвращаемые выходные данные не влияет то, что значение DPI вызывающего потока не влияет.

Примечание

Заголовок winuser.h определяет LoadCursorFromFile в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

См. также раздел

Основные понятия

Курсоры

LoadCursor

Справочные материалы

SetCursor

SetSystemCursor