Condividi tramite

Funzione DragQueryFileA (shellapi.h)

  • Articolo

Recupera i nomi dei file eliminati risultanti da un'operazione di trascinamento della selezione riuscita.

Sintassi

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

Parametri

[in] hDrop

Tipo: HDROP

Identificatore della struttura che contiene i nomi di file dei file eliminati.

[in] iFile

Tipo: UINT

Indice del file su cui eseguire una 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 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 di 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 di terminazione.

Se il valore di 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 dell'indice è compreso tra zero e il numero totale di file eliminati e l'indirizzo del buffer lpszFile è null, il valore restituito è la dimensione richiesta, in caratteri, del buffer, non incluso carattere Null di terminazione.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows XP [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
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 (introdotto in Windows 10, versione 10.0.10240)

Vedere anche

dragQueryPoint