Função DragQueryFileA (shellapi.h)

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

[in] iFile

Tipo: UINT

Índice do arquivo a ser consultado. Se o valor desse parâmetro for 0xFFFFFFFF, DragQueryFile retornará uma contagem dos arquivos removidos. Se o valor desse parâmetro estiver entre zero e o número total de arquivos descartados, 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 de 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 lpszFile .

Retornar valor

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 terminação.

Se o valor do índice for 0xFFFFFFFF, o valor retornado será uma contagem dos arquivos descartados. Observe que a variável de índice 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 do buffer lpszFile for NULL, o valor retornado será o tamanho necessário, em caracteres, do buffer, sem incluir o caractere nulo de terminação.

Comentários

Requisitos

Confira também

DragQueryPoint