Compartir a través de


Función LoadCursorFromFileA (winuser.h)

Crea un cursor basado en los datos contenidos en un archivo.

Nota

Esta función se ha reemplazado por la función LoadImage (con LR_DEFAULTSIZE y marcas de LR_LOADFROMFILE establecidas).

Sintaxis

HCURSOR LoadCursorFromFileA(
  [in] LPCSTR lpFileName
);

Parámetros

[in] lpFileName

Tipo: LPCTSTR de

Origen de los datos del archivo que se van a usar para crear el cursor. Los datos del archivo deben estar en . CUR o . Formato ANI.

Si la palabra de orden superior de lpFileName es distinto de cero, es un puntero a una cadena que es un nombre completo de un archivo que contiene datos de cursor.

Valor devuelto

Tipo: HCURSOR

Si la función se ejecuta correctamente, el valor devuelto es un identificador del nuevo cursor.

Si se produce un error en la función, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError. GetLastError puede devolver el siguiente valor.

Código devuelto Descripción
ERROR_FILE_NOT_FOUND
No se encuentra el archivo especificado.

Observaciones

Virtualización de PPP de

Esta API no participa en la virtualización de PPP. La salida devuelta no se ve afectada por el PPP del subproceso que realiza la llamada.

Nota

El encabezado winuser.h define LoadCursorFromFile como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de winuser.h (incluya Windows.h)
biblioteca de User32.lib
DLL de User32.dll

Consulte también

conceptual de

cursores de

loadCursor

de referencia de

SetCursor

SetSystemCursor