LoadCursorFromFileA 函式 (winuser.h)

根據檔案中包含的數據建立數據指標。

注意

LoadImage 函式已取代此函式，LR_DEFAULTSIZE和LR_LOADFROMFILE旗標設定 ) (。

語法

HCURSOR LoadCursorFromFileA(
  [in] LPCSTR lpFileName
);

[in] lpFileName

類型： LPCTSTR

要用來建立數據指標之檔案數據的來源。檔案中的數據必須位於其中一個中。CUR 或。ANI 格式。

如果 lpFileName 的高序字不是零，則它是字串的指標，該字串是包含數據指標數據之檔案的完整名稱。

類型： HCURSOR

如果函式成功，則傳回值是新數據指標的句柄。

如果函式失敗，則傳回值為 NULL。若要取得擴充的錯誤資訊，請呼叫 GetLastError。 GetLastError 可能會傳回下列值。

傳回碼	Description
ERROR_FILE_NOT_FOUND	找不到指定的檔案。

此 API 不會參與 DPI 虛擬化。傳回的輸出不會受到呼叫線程的 DPI 影響。

注意

winuser.h 標頭會根據 UNICODE 預處理器常數的定義，將 LoadCursorFromFile 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。