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