DragQueryFileW-Funktion (shellapi.h)
Ruft die Namen der abgelegten Dateien ab, die aus einem erfolgreichen Drag-and-Drop-Vorgang resultieren.
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 abgelegten Dateien enthält.
[in] iFile
Typ: UINT-
Index der zu abfragenden Datei. Wenn der Wert dieses Parameters 0xFFFFFFFF ist, gibt DragQueryFile eine Anzahl der abgelegten Dateien zurück. Wenn der Wert dieses Parameters zwischen Null und der Gesamtanzahl der gelöschten Dateien liegt, kopiert DragQueryFile den Dateinamen mit dem entsprechenden Wert in den Puffer, auf den der lpszFile Parameter verweist.
[out] lpszFile
Typ: LPTSTR-
Die Adresse eines Puffers, der den Dateinamen einer abgelegten Datei empfängt, wenn die Funktion zurückgegeben wird. Dieser Dateiname ist eine mit Null beendete Zeichenfolge. Wenn dieser Parameter NULL-ist, gibt DragQueryFile die erforderliche Größe in Zeichen dieses Puffers 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 eine Anzahl der kopierten Zeichen, nicht einschließlich des endenden NULL-Zeichens.
Wenn der Indexwert 0xFFFFFFFF ist, ist der Rückgabewert eine Anzahl der abgelegten Dateien. Beachten Sie, dass die Indexvariable selbst unverändert zurückgegeben wird und daher 0xFFFFFFFF bleibt.
Wenn der Indexwert zwischen Null und der Gesamtzahl der verworfenen Dateien liegt und die lpszFile- Pufferadresse NULL-ist, ist der Rückgabewert die erforderliche Größe des Puffers, nicht das endende NULL-Zeichen eingeschlossen.
Bemerkungen
Anmerkung
Der header shellapi.h 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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | shellapi.h |
| Library | Shell32.lib |
| DLL- | Shell32.dll (Version 4.0 oder höher) |
| API-Satz | ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240) |