Compartilhar via

Função DragQueryFileA (shellapi.h)

  • Artigo

Recupera os nomes de arquivos descartados resultantes de uma operação de arrastar e soltar bem-sucedida.

Sintaxe

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

Parâmetros

[in] hDrop

Tipo: HDROP

Identificador da estrutura que contém os nomes de arquivo dos arquivos descartados.

[in] iFile

Tipo: UINT

Índice do arquivo a ser consultado. Se o valor desse parâmetro for 0xFFFFFFFF, DragQueryFile retornará uma contagem dos arquivos descartados. Se o valor desse parâmetro estiver entre zero e o número total de arquivos removidos, DragQueryFile copiará o nome do arquivo com o valor correspondente para o buffer apontado pelo parâmetro lpszFile.

[out] lpszFile

Tipo: LPTSTR

O endereço de um buffer que recebe o nome do arquivo de um arquivo descartado quando a função retorna. Esse nome de arquivo é uma cadeia de caracteres terminada em nulo. Se esse parâmetro for NULL, DragQueryFile retornará o tamanho necessário, em caracteres, desse buffer.

cch

Tipo: UINT

O tamanho, em caracteres, do buffer de lpszFile.

Valor de retorno

Tipo: UINT

Um valor diferente de zero indica uma chamada bem-sucedida.

Quando a função copia um nome de arquivo para o buffer, o valor retornado é uma contagem dos caracteres copiados, não incluindo o caractere nulo de encerramento.

Se o valor do índice for 0xFFFFFFFF, o valor retornado será uma contagem dos arquivos descartados. Observe que a variável de índice em si retorna inalterada e, portanto, permanece 0xFFFFFFFF.

Se o valor do índice estiver entre zero e o número total de arquivos descartados e o endereço de buffer lpszFile estiver NULL, o valor retornado será o tamanho necessário, em caracteres, do buffer, não incluindo o caractere nulo de encerramento.

Observações

Nota

O cabeçalho shellapi.h define DragQueryFile como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho shellapi.h
biblioteca Shell32.lib
de DLL Shell32.dll (versão 4.0 ou posterior)
conjunto de API ext-ms-win-shell-shell32-l1-2-1 (introduzido no Windows 10, versão 10.0.10240)

Consulte também

do DragQueryPoint