共用方式為


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 [僅限桌面應用程式]
目標平台 Windows
標頭 shellapi.h
程式庫 Shell32.lib
Dll Shell32.dll (4.0 版或更新版本)
API 集合 ext-ms-win-shell-shell32-l1-2-1 (在 Windows 10 10.0.10240 版中引進)

另請參閱

DragQueryPoint