共用方式為

DragQueryFileA 函式 （shellapi.h）

  • 發行項

擷取成功拖放作業所產生的已卸除檔案名稱。

語法

UINT DragQueryFileA(
  [in]  HDROP hDrop,
  [in]  UINT  iFile,
  [out] LPSTR lpszFile,
        UINT  cch
);

參數

[in] hDrop

類型：HDROP

結構標識碼，其中包含已卸除檔案的檔名。

[in] iFile

類型：UINT

要查詢的檔案索引。 如果此參數的值0xFFFFFFFF，DragQueryFile 會傳回捨棄的檔案計數。 如果此參數的值介於零和捨棄的檔案總數之間，DragQueryFile 會將具有對應值的檔名複製到 lpszFile 參數所指向的緩衝區。

[out] lpszFile

類型：LPTSTR

當函式傳回時，接收已卸除檔案檔名的緩衝區位址。 這個檔名是以 Null 結尾的字串。 如果此參數 NULL，DragQueryFile 會傳回這個緩衝區所需的大小，以字元為單位。

cch

類型：UINT

lpszFile 緩衝區的大小，以字元為單位。

傳回值

類型：UINT

非零值表示呼叫成功。

當函式將檔名複製到緩衝區時，傳回值是複製的字元計數，不包括終止的 Null 字元。

如果索引值是0xFFFFFFFF，傳回值就是卸除檔案的計數。 請注意，索引變數本身會傳回不變，因此會維持0xFFFFFFFF。

如果索引值介於零和已卸除的檔案總數之間，且 lpszFile 緩衝區位址 NULL，則傳回值是緩衝區所需的大小，不包含終止 null 字元。

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 shellapi.h
連結庫 Shell32.lib
DLL Shell32.dll 版（4.0 版或更新版本）
API 集 ext-ms-win-shell-shell32-l1-2-1 （在 Windows 10 版本 10.0.10240 中引進）

另請參閱

DragQueryPoint