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

Статья
07/21/2023

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

Примечание

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

Синтаксис

HCURSOR LoadCursorFromFileW(
  [in] LPCWSTR lpFileName
);

Параметры

[in] lpFileName

Тип: LPCTSTR

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

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

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

Тип: HCURSOR

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

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

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

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

Требования


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