DragQueryFileW

ドラッグアンドドロップ操作の結果としてドロップされたファイル名を取得する。(Unicode)

DragQueryFileW hDrop, iFile, lpszFile, cch

hDrop : [intptr] 型: HDROP ドロップされたファイル名を含む構造体の識別子。
iFile : [int] 型: UINT 照会するファイルのインデックス。0xFFFFFFFF の場合はドロップされたファイル総数を返す。0 から総数の間の値なら対応するインデックスのファイル名を lpszFile にコピーする。
lpszFile : [wstr] 型: LPTSTR ドロップされたファイル名を受け取るバッファのアドレス。NULL 終端文字列。NULL を指定すると必要なバッファサイズ(文字単位)を返す。
cch : [int] 型: UINT lpszFile バッファのサイズ(文字単位)。

(プラグイン / モジュール : shell32.dll)

解説

ドラッグアンドドロップ操作の結果としてドロップされたファイル名を取得する。(Unicode)

[戻り値]
型: UINT 0 以外の値は成功を示す。ファイル名をバッファにコピーした場合、戻り値は終端 NULL
を含まないコピーされた文字数。iFile が 0xFFFFFFFF の場合、戻り値はドロップされたファイル数。iFile が 0
から総数の間で lpszFile が NULL の場合、戻り値は必要なバッファサイズ(文字単位、終端 NULL を含まない)。

[備考]
shellapi.h ヘッダは UNICODE プリプロセッサ定数の定義に基づいて ANSI または Unicode
版を自動選択するエイリアスとして DragQueryFile
を定義している。エンコーディング非中立なコードでエイリアスを混用するとコンパイル時または実行時エラーを招く可能性がある。

サンプル逆引き (1)

情報