Condividi tramite

Funzione DragQueryFileA (shellapi.h)

  • Articolo

Recupera i nomi dei file eliminati che derivano da un'operazione di trascinamento riuscita.

Sintassi

UINT DragQueryFileA(
  [in]  HDROP hDrop,
  [in]  UINT  iFile,
  [out] LPSTR lpszFile,
        UINT  cch
);

Parametri

[in] hDrop

Tipo: HDROP

Identificatore della struttura contenente i nomi di file dei file eliminati.

[in] iFile

Tipo: UINT

Indice del file da eseguire in query. Se il valore di questo parametro è 0xFFFFFFFF, DragQueryFile restituisce un conteggio dei file eliminati. Se il valore di questo parametro è compreso tra zero e il numero totale di file eliminati, DragQueryFile copia il nome del file con il valore corrispondente al buffer a cui punta il parametro lpszFile .

[out] lpszFile

Tipo: LPTSTR

Indirizzo di un buffer che riceve il nome del file di un file eliminato quando la funzione restituisce. Questo nome file è una stringa con terminazione null. Se questo parametro è NULL, DragQueryFile restituisce le dimensioni necessarie, in caratteri, di questo buffer.

cch

Tipo: UINT

Dimensioni, in caratteri, del buffer lpszFile .

Valore restituito

Tipo: UINT

Un valore diverso da zero indica una chiamata riuscita.

Quando la funzione copia un nome di file nel buffer, il valore restituito è un conteggio dei caratteri copiati, non incluso il carattere null terminante.

Se il valore dell'indice è 0xFFFFFFFF, il valore restituito è un conteggio dei file eliminati. Si noti che la variabile di indice stessa restituisce invariata e pertanto rimane 0xFFFFFFFF.

Se il valore di indice è compreso tra zero e il numero totale di file eliminati e l'indirizzo del buffer lpszFile è NULL, il valore restituito è la dimensione necessaria, in caratteri, del buffer, non incluso il carattere null terminante.

Commenti

Nota

L'intestazione shellapi.h definisce DragQueryFile come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shellapi.h
Libreria Shell32.lib
DLL Shell32.dll (versione 4.0 o successiva)
Set di API ext-ms-win-shell-shell32-l1-2-1 (introdotta in Windows 10, versione 10.0.10240)

Vedi anche

DragQueryPoint