Share via

DragQueryFileW-Funktion (shellapi.h)

  • Artikel

Ruft die Namen gelöschter Dateien ab, die sich aus einem erfolgreichen Drag-and-Drop-Vorgang ergeben.

Syntax

UINT DragQueryFileW(
  [in]  HDROP  hDrop,
  [in]  UINT   iFile,
  [out] LPWSTR lpszFile,
        UINT   cch
);

Parameter

[in] hDrop

Typ: HDROP

Bezeichner der Struktur, die die Dateinamen der gelöschten Dateien enthält.

[in] iFile

Typ: UINT

Index der abzufragenden Datei. Wenn der Wert dieses Parameters 0xFFFFFFFF ist, gibt DragQueryFile die Anzahl der gelöschten Dateien zurück. Wenn der Wert dieses Parameters zwischen null und der Gesamtzahl der gelöschten Dateien liegt, kopiert DragQueryFile den Dateinamen mit dem entsprechenden Wert in den Puffer, auf den der parameter lpszFile verweist.

[out] lpszFile

Typ: LPTSTR

Die Adresse eines Puffers, der den Dateinamen einer gelöschten Datei empfängt, wenn die Funktion zurückgibt. Dieser Dateiname ist eine Zeichenfolge mit NULL-Beendigung. Wenn dieser Parameter NULL ist, gibt DragQueryFile die erforderliche Größe dieses Puffers in Zeichen zurück.

cch

Typ: UINT

Die Größe des lpszFile-Puffers in Zeichen.

Rückgabewert

Typ: UINT

Ein Wert ungleich null gibt einen erfolgreichen Aufruf an.

Wenn die Funktion einen Dateinamen in den Puffer kopiert, ist der Rückgabewert die Anzahl der kopierten Zeichen, ohne das abschließende NULL-Zeichen.

Wenn der Indexwert 0xFFFFFFFF ist, ist der Rückgabewert die Anzahl der gelöschten Dateien. Beachten Sie, dass die Indexvariable selbst unverändert zurückgibt und daher 0xFFFFFFFF bleibt.

Wenn der Indexwert zwischen null und der Gesamtzahl der gelöschten Dateien liegt und die lpszFile-PufferadresseNULL ist, entspricht der Rückgabewert der erforderlichen Größe des Puffers in Zeichen, ohne das abschließende NULL-Zeichen.

Hinweise

Hinweis

Der Shellapi.h-Header definiert DragQueryFile als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shellapi.h
Bibliothek Shell32.lib
DLL Shell32.dll (Version 4.0 oder höher)
APIs ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

DragQueryPoint