Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Cria um cursor com base nos dados contidos em um arquivo.
Nota
Essa função foi substituída pela função LoadImage (com sinalizadores LR_DEFAULTSIZE e LR_LOADFROMFILE definidos).
Sintaxe
HCURSOR LoadCursorFromFileA(
[in] LPCSTR lpFileName
);
Parâmetros
[in] lpFileName
Tipo: LPCTSTR
A fonte dos dados de arquivo a serem usados para criar o cursor. Os dados no arquivo devem estar em qualquer um . CUR ou . Formato ANI.
Se a palavra de alta ordem de lpFileName não for zero, será um ponteiro para uma cadeia de caracteres que é um nome totalmente qualificado de um arquivo que contém dados de cursor.
Valor de retorno
Tipo: HCURSOR
Se a função for bem-sucedida, o valor retornado será um identificador para o novo cursor.
Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError. GetLastError pode retornar o valor a seguir.
| Código de retorno | Descrição |
|---|---|
|
O arquivo especificado não pode ser encontrado. |
Observações
Virtualização de DPI
Essa API não participa da virtualização de DPI. A saída retornada não é afetada pelo DPI do thread de chamada.Nota
O cabeçalho winuser.h define LoadCursorFromFile como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winuser.h (inclua Windows.h) |
| biblioteca | User32.lib |
| de DLL |
User32.dll |
Consulte também
Conceitual
de referência de