DragQueryFileA-Funktion (shellapi.h)

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

Anforderungen

Weitere Informationen

DragQueryPoint