Función DragQueryFileA (shellapi.h)
Recupera los nombres de los archivos descartados resultantes de una operación correcta de arrastrar y colocar.
Sintaxis
UINT DragQueryFileA(
[in] HDROP hDrop,
[in] UINT iFile,
[out] LPSTR lpszFile,
UINT cch
);
Parámetros
[in] hDrop
Tipo: HDROP
Identificador de la estructura que contiene los nombres de archivo de los archivos descartados.
[in] iFile
Tipo: UINT
Índice del archivo que se va a consultar. Si el valor de este parámetro es 0xFFFFFFFF, DragQueryFile devuelve un recuento de los archivos quitados. Si el valor de este parámetro está entre cero y el número total de archivos quitados, DragQueryFile copia el nombre de archivo con el valor correspondiente al búfer al que apunta el parámetro lpszFile .
[out] lpszFile
Tipo: LPTSTR
Dirección de un búfer que recibe el nombre de archivo de un archivo quitado cuando la función devuelve. Este nombre de archivo es una cadena terminada en null. Si este parámetro es NULL, DragQueryFile devuelve el tamaño necesario, en caracteres, de este búfer.
cch
Tipo: UINT
Tamaño, en caracteres, del búfer lpszFile .
Valor devuelto
Tipo: UINT
Un valor distinto de cero indica una llamada correcta.
Cuando la función copia un nombre de archivo en el búfer, el valor devuelto es un recuento de los caracteres copiados, no incluido el carácter nulo de terminación.
Si el valor de índice es 0xFFFFFFFF, el valor devuelto es un recuento de los archivos quitados. Tenga en cuenta que la propia variable de índice devuelve sin cambios y, por tanto, permanece 0xFFFFFFFF.
Si el valor del índice está entre cero y el número total de archivos descartados, y la dirección del búfer lpszFile es NULL, el valor devuelto es el tamaño necesario, en caracteres, del búfer, no incluido el carácter nulo de terminación.
Comentarios
Nota
El encabezado shellapi.h define DragQueryFile como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shellapi.h |
| Library | Shell32.lib |
| Archivo DLL | Shell32.dll (versión 4.0 o posterior) |
| Conjunto de API | ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240) |