DragQueryFileA-Funktion (shellapi.h)

  • Artikel

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

Syntax

UINT DragQueryFileA(
  [in]  HDROP hDrop,
  [in]  UINT  iFile,
  [out] LPSTR 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 eine 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 lpszFile-Parameter 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 NULL-beendete Zeichenfolge. 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 ohne Zero gibt einen erfolgreichen Aufruf an.

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

Wenn der Indexwert 0xFFFFFFFF ist, ist der Rückgabewert eine Anzahl der gelöschten 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 gelöschten Dateien liegt und die Pufferadresse lpszFileNULL ist, ist der Rückgabewert die erforderliche Größe des Puffers in Zeichen, ohne das beendende 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 nicht codierungsneutralem Code 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