Compartir a través de

Función DragQueryFileA (shellapi.h)

  • Artículo

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 quitados.

[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 eliminados. Si el valor de este parámetro está entre cero y el número total de archivos eliminados, DragQueryFile copia el nombre de archivo con el valor correspondiente al búfer al que apunta el parámetro lpszFile.

[out] lpszFile

Tipo: LPTSTR de

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 de 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 eliminados, y la dirección del búfer de lpszFile es NULL, el valor devuelto es el tamaño necesario, en caracteres, del búfer, no incluir el carácter nulo de terminación.

Observaciones

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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de shellapi.h
biblioteca de Shell32.lib
DLL de Shell32.dll (versión 4.0 o posterior)
conjunto de API de ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240)

Consulte también

dragQueryPoint