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)

Consulte también

DragQueryPoint